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UP TO 25% LOWER COST PER PAGE THAN LASER PRK 
HP OFFICEJET PRO ALL-IN-ONES STARTING AT $299. 


They fax, scan, copy and deliver laser^qualify printing—at an impressively low cost 
per page. Individual ink cartridges save money too, because you only replace what runs out. 
Hf^ PC Magazine's Readers' Choice for service and reliability for 15 years running. 



GOOD 


$399. 


H P Officojet Pro L/5S0 AiO. 
Up to 35 pogos a minutcj- 


$299. 


To learn more, visit hp,corn/go/doesifa 11. Call 1-800-888-3119 Or visit your (ocol reseller or retofter. 



*Co5i per pcge (CPP) lo^ef supplies comportsons bosad on publtehod manufectufer specilkoJTons ot the h^besrccpocity cortridges available forcdcx kasor alf-h-Ofits undtfT 
StOOO otid mono bsorolViTi^OTiosundoi $500^ os reported by Cunotrt Ar^oiysts, Inc. asol July 2006. Offfcssjet Pro L7500/17600A770Q AiOCPP on HP S& kargo Ink 

Corlridgos (not inducied., sotd sqparoldy) csfiiriotod streiat price and publishiKJ yield. Results mcFy vary. Estimated US. retell price. Actual price rtray vary. Simubted images, 
ft"2007Hcwiett-PadtardDevelopiTtentCcimpany, L.P. 
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Thanks to The Missing Sync, Mac users are no longer second-class citizens when It comes to keeping their 
mobile devices In sync. Whether it’s a Windows Mobile 6 device, a BlackBerry or even a Palm Treo, there's a 
Missing Sync product made to connect and synchronize that device with Mac OS X. 


Syncs Contacts, Calendars, Tasks Complete Notes Syncronization 


Supports Address Book, iCal, 
Microsoft Entourage 2004 
Outstanding field support, even 
syncs Address Book contact photos 
Supports calendar event reminders 
and detached events 
Sync Services-savvy for syncing 
with third-party apps 


Includes Mark/Space Notebook for 
Mac to create, edit, categorize, sort 
and search through notes 
Also supports Microsoft Entourage 
2004 and Bare Bones Yojimbo 
Full support for Sync Services and 
.Mac syncing between Macs 


iPhoto and ITunes Integration 

• Imports photos and videos from 
mobile devices into iPhoto albums 
or folders in the Finder 

• Resizes and downloads selected 
iPhoto albums to the device for 
handheld viewing and slideshows 

• Downloads DRM-free music and 
podcasts for mobile playback 


The Missing Sync for BlackBerry, Palm OS or Windows Mobile is available in single-user licenses for $39.95 
or in multi-user packs for any size organization, The Missing Sync family of products provide a Mac-centric 
synchronization solution second to none. 


Visit www.markspace.com/reliable today to see how easy it is 
to sync the iatest smartphones and mobiie devices with the Mac. 








Reliable Handheld Synchronization for Mac 
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NEW Mac Pro 

■ NEW Up 10 Srcore peiformance 
wilh up to 2 Qusd-Core Intel Xeon 
5400 pnjcas^of^ at up to 3iGHr 

m NEWlMf Radeon HD 2600 XT 
graphics with 256MB GTO 

■ HEW* Fotir intemal drive teys 
support up to 4TB of storage 

'2289-'100 malign rebate 
starting at ^ 2189 ! i737im 


NEW MacBook' 

■ NEWiU))lo2.«HzlnielCoi«2Diw 

processor wlrti45nm ledirology 
m NEW! Up to 25DGB hard disk drive 

■ NFW!Upto2GB0DRiMM 

■ liy glossy widesaeen display 

■ 302,1 In wireless ® iSightcamefa 

'1094-75 mail-lntebaie 

starting at ^7079/ 074O4921 


NEW MacBook Air 

■ HptolSGHz Intel Core 2 Duo 
processor ■ Only (L76 " thin 

■ Wetqhs)ijst3!lBJ 

■ BOGB HD m MOB solid stale drive 

■ 802 Jin wireless ■ iSighteaftiera 

■ 13.3" glossywidesoeen backlit LCD 

'1748^ -^50 malHn rebate 
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NEW MacBook' Pro 

■ NEVi^! Up to 2iGH2 Intel Core 1 Duo 
processor with 45nm lechnoiugy 

■ NEW U p to 6 MB processor cache 

■ N£WI 17" rmxlel with arsenic-free 
glass and optional mercuryJree 
LED backlit display 
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Mac mini 

■ Intel Core 2 Duo processtK 

atspeedsupto ZGHz 

« IGBSORAM • UptolMHD 
« SuperOrlvf with dual-layer 
support or Combo drive 

■ 802J1 g wireless Si Grgahit Elfiernet 

'594 “^25 malHn rebate 
starting at * 569 / mmsi 


Accessories for your Mac! 

Call or visit our Web site for the best selection of add-ons for your Mac! 


BELKIN, 
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Black Sleeve 
for MacBook Air 
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20" Value Series 

Widescreen LCD 
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S530 laser for Mac 
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320GB My Passport 

EssenUal Hard Drive 

0f\ly^l44^! *7389082 

External Hard Drive , 
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lac accessories, Mac software and iPod accessories! 


m Authorized Reseller 



r MacMall N 
Exclusive Deals! 

Get up to ‘200 cash back!’ 
FREE Parallels Desktop 3.01 
HP All'in-One Inkjet 
^ Printer only *19*1 > 


Mac! 


NEWiMac 


■ FASTER! Up to 3.06GHz Intel Core 2 Duo processor 

■ NEW! Up 10 2GB 800MHz DDR2 SDRAM 

■ Up to 500GB bard drive 

■ 20" or 24" glossy widescreen LCD 

■ SX SijperDrive' with dual layer 

■ iSigbf, wireless and Gigabit Ethernet 
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iMac start mg at 
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Your iPod superstore! 
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Apple Universal iPod Dock 
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Ntke + iPod Sport Kit 
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1-800-MACMALL (1-800-622-6255) www.macnnall.com 
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Call for IPods in all colon and capacities! 
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#7297625 IPod* nano (Silver) 

#7297631 IPod* classic (Silver) 

#7373111 iPod*touch 8GB 
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8 REAL basic 2008 

Cross-Platform that Really Works! 


Create your own software. Easily. 

REALbasic is the powerful, easy-to-use tool for creating your own software. At REAL Software, we call 
it a problem solver. You've probably said, "Wouldn't it be great if there was an application that could..." 
REALbasic fills that blank. 

REALbasic compiles native applications for Mac OS X, Windows and Linux from one set of source code. 
Each version of your software looks and works just as it should in each environment. You can even create 
a Universal Binary with one mouse-click. 
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From the Editor — 

1 M MacTech's first issue since WWDC 2008, where we can repon on., .nothing! 'Fliat's right, WWDC 

l#V promised us a new release of Mac OS X with no new features! Of course, that's far from true: there’s 

W W plenty in the Snow Leopard release debuted at WWDC. Unfortunately, aH of the realfy juicy stuff was 
presented outside of the keynote and is under NDA. The keynote was all about the il^hone, the hardware and the 
upcoming software SDK. Both of which will be released by the time you get this in print. Interestingly, tiie new 
hardware hasn’t necessarily prompted pure lust for the latest and abandonment of tlie original model Many people 
are simply going to hang on to their rev. 1 device. Others I know are going to sell it off ~ sometimes at a profit! 
Finally, many iPhone devs 1 know are going to buy a 3G unit, but keep their rev. 1 model for, you guessed it, 
development. 

What about Mac OS X? Enough of the details are publically available on Apple’s Snow Leopard page 
(http://www.apple.com/macosx/snowleopard/). Apple’s Open Computing Laaguage (OpenCL) will be a huge 
bo<m to anyone writing computatit)nally intensive software. QpenCL allow,s a developer to easily take advantage i 

of die computing power available on the GPU (Graphics Prtxessing Unit) of the video card, or cards* available in i 

each machine. GPUs are tuned for different types of computations than CPUs, but make no mistake: when running 
an optimized computation, they are thousands of time.s faster than a CPU. Modern CPU.S are good at branching - j 

code that needs to make decLsioas, GPUs are gtK>d at taking a block of code and running straight ahead w'ith it, | 

Combine the two, and there’s a powerful platform, fm looking forward to seeing a mini-Cray by topfiing out a 
MacPro with RAM and GPUs, f'm also looking forward to Apple outright owning scientific computing thanks to 
this development. 

Also of interest is QuickTime X. Think about this for a minute: QuickTime w^as rewTitten for the iPhone. Now, 
diat version is being ixirted to de,sktop OS X. Thafs pretty awesome. QuickTime X is being touted as Ixing light 
and fast. It's a ground up rewrite, so, fm sure it is. More im|X)rtantly, it's a ground up rewrite. Unfortunately, 
QuickTime has been a source of .security ksues for Apple and OS X. Ifs Apple’s Internet Explorer. QuickTime is 
an old framework at this jxxnt, and a rewTite makes a lot of sense, Uiere’s likely tons of code tJiat can just go 
away. 

Finally, WebKit has been swirling around my head lately. A lot. Wlien Apple first announced its use of KIITML 
and die creation of WebKit, 1 thought, “oh, nice. Good for Apple - they'll have one more piece of the puzzJe.” I 
did not think that the ado]:>tion of WebKit would be w'hat it is now. Naturally, developers on Mac GS X can 
incorporate the use of WebKit into their own applications (like Entourage 2008 does). Safari (WebKit) nins on 
Windows now, too. Don't forget, though, that WebKit is open source. A new browser named Gpus Palladianum, 
des igned for secu rity (http: / /www. tech. com / secu rebrowser, him 1 ) w i 11 be leveragi ng WebK il. Gtx jgle’s And roid smart 
phone OS is using WebKit (htfp://webkilorg/blog/142/android-iises-webkit/). Yahoo’s Messenger renders IM 
C{)nversations using WebKit. Even text editors like BBEdit and TextMate rely on WebKit somewhere. The list goes 
on at length. You should lx? reading die Surfin Safari blog (hHp://webkil,org/blog), using the nightly builds 
fhttp://rTightly.webkii.org), and reporting bugs. 

This month’s content revolves around backup, and I m thrilled Co have long time Mac author Joe Kissell guide 
us through an important topic: creating a backup policy. More often than not, backup systenxs and scliedules are 
chosen without truly defining the as.sels being protected and matching system needs to that of the organization 
being protected. Henri Slushak writes about Lbackup, open source backup program. I*astly on the backup front, 

I review tw^o Take Control titles that serve tw^o different beginning audiences implementing backup. 

In addition to the other great content this month, please check out the MacTech Spotlight leaturing Andy Lee. 

Andy is a “part-time” Cocoa developer. He’s also the author of AppKiDo, an application that other developers love. ' 

It goes to show^ how you can get involved in OS X development and have an impact no matter if ifs your cLiy job 
or not. How are you getting involved? 

1 

Ed Marczak, 

Executive Editor 
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Major Releases, 

Benchmarks, and Feedback 

Benchmarks and how the community contributes 


By Neil Ticktin, EditoNn-Chief/PubHsher 




Complexities 

Software is a complex beast these days, and it has been 
for a while. Just take a look at the stora^^e on your local 
machine, and you will likely see luintlreds of thousands of 
files and folders, if not a million or more. 

OS X, like other OSes, has many different configurations 
- more than is realistically possible for anyone to test on even 
for the biggest of companies, As a result, devckipers have 
gone into the mode of trying to w rite the l>est C|uaUty sofiw^ure 
that they can, do realistic le.sting, and then focus enormous 
efforts on listening for problems, and reacting to them. Both 
Microsoft and Apple are great examples of having done this 
on the Mac. 

But w^iih this apprcjach comes a lot of respcmsibility on the 
community, especially those that are technical in the market. 
As a MacTech reader you are at the core of this market). Like 
it or not, this responsibility lands largely on your shoulders. 

Leopard and Microsoft Office 2008 are both giving us 
good examples of w'hat to look for, what to expect, and what 
our responsibilities are. 

Benchmarks 

MacTech strives to give you quality benchmarks. We've 
done it for virtualization environments, Rosetta, hard 
drives, and Microsoft Office. In all of these cases, like 
anyone else that does high end testing, we do this in 
‘Virgin” or “clean” environments. It's the only way to do 
the testing, as you cannot penalize a product by putting it 
on a machine that needs to have a disk utility run on it, or 
has systejn problems, or a congested network. 

Benchmarks are a great tool — they allows you to see, 
in an “apples to apples” comparison, how well a product 
performs. As the pros in the indu.stry, you take those 
benchmarks and start to apply them to your real world 
setting, as only you know the setups you have. When 
major releases come out, the distance between a clean 


setup and yours may be that much more important, and 
here, your involvement grows. 

Let’s lake Leopard and Microsoft Office 2008 as examples. 
Both of tltese are herculean efforts on behalf of their 
developers, and are massive releases. As anyone experienced 
wd! tell you, releases of this size are never perfect. There's no 
way for the devekiper U) test all permutations of hardware, OS 
release and other softw'are in.stalled on the machine. 

Community Feedback 

So, whaCs a geek to do? Well, that’s a good question, When 
major new' releases come out, you should get a copy in your 
liands as fast as possible, and start to use it yourself. Wliat you 
should not to is put yourself in a situation where you are 
supporting otliers using it, and furthermore, you should not 
yourself lx? in a positit^n where yc^u are dependent on it 
w'orking. 

As you are able to exf>eriineni w'itli these new versions, 
you want to understand what, if any, pitfalls you fall into. You 
should be looking for bugs, incompatibilities and more. 

Now here's the important part ... 
you need to report them. 

This Is so much more important today than it was in the 
past. As the technical cx>nimunity, it's become our responsibility 
to report the prtdilems so that they can be fixed. If we don't 
report them, they are not likely to be fixed. Griping about 
issues on public mailing lists and in blogs doesn’t count. Even 
more important, the bug tracking and reporting tools have 
become sophisticated enough that they not only provide 
information on what you are experiencing, but give statistical 
information to help rank the importance of the problems within 
the community. 
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Apple and Mac OS X / 

Mac OS X Server 

As rmny in the industry will tell you, Apple versions tend 
to stabilize on the 3 version. For example: Leopard will likely 
stabilize quite a bit on 10.53^ It just takes that many interactions 
of versions and general usage to get the major kinks worked 
out. That’s not to say that there won't be bugs with a .3 version^ 
Flistorically, the 3 version is the one dial generally runs well, 
and then has incremental improvements frtjm there. 

Every time you have an application that unexpectedly 
quits, a dialog appears asking for permission to send 
information to Apple. You should use this as much as you can, 
as it's not only fast, but it gives very specific machine generated 
information that is very helpful to Apple in understanding the 
situation diat just happened 

In looking through Applets online supp<irt, you'll see a way 
to give Apple feedback on whether an answer was helpful to 
you or not. Take the few seconds to let them know^ if it was 
helpful or not — over time, it makes a difference. 

If you are looking for help on an issue, there are a couple 
of things that you can do. First, you can use MacTech’s 
‘'Community Search Engine” Here, weVe selected the best web 
sites in the community, including Apple’s suppon sections, to 
be a part of the search. So, wlien you are looking for ^'rebuild 
degraded RAID ” you1l get only those search results relevant to 


the Mac and OS X, and not the hundreds of thousands of 
answers you miglit see with a general Google search. See die 
left navigation bar on MacTech.com or 
hHp://www.mactech.com/advanced&earch.htTTil — either way 
don’t forget to press the “Mac Community” radio button for that 
type of search. 

Apple uses their “Bug Reported system at 
http://bugreporter.apple.com/ as the primary way to report bugs 
to Apple, ADC Membersliip (free registradon) is required to use 
this tool. And, there’s a great article on AFP54B.com that talks about 
the best ways to use Apple’s system “ see 
htfp://www.a)p548.com/artide.php?stDryi=20051102133234150 

Microsoft Office 

Microsoft also uses a variety of ways to have people report 
in information. In fact, they appear to have broader methods of 
interacting than Apple does, 

Microsoft has a “Send Feedback” command in the Help 
menu that redirects users to a page on the Mactopia web site. 
This mfomiation is generally used to plan future products For 
Microsoft. 

See http://www.microsoft.com/mac/suggesfions.mspx 

Like Apple, the online Help sections on the Microsoft web 
site also asks, “Was tliis helpful?” Clicking the “No” or 
“Somewhat” buttons prompts for slighdy more detail. When the 
community tells diem why a topic isn’t helpful, they can use 
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that feedback to change die topic online, without liaving to wait 
for the next major release for offline content updates. Microsoft 
calls this ‘'continuous publishing ” 

If you are looking for help on any of the MiCTOsoft Office 
products, you should look to the newsgroup fomnis. Here, 
there are MVPs (not Microsoft employees) tliat know the 
products in depth, and will give you very candid answers. They 
are particularly good at answering "how^ to" questions. In 
addition, Microsoft read the posts looking for problem reports, 
and if appropriate will compare diem to reported issues, or 
create a new one. Here are the URLs for the web interface into 
the newsgroup fomms: 

http://www.oFficeFormac.com/ProductFoa»ms/Wofd/ 
http://w^w.offtceforrnocxom/ProductFo^ums/Excd/ 
hftp://www*officeformac.com/ProducfForums/PowerPoint/ 
http://www.officeformacxom/ProdudFonjmi/Entoyrage/ 
http: //www.officefoimac .com/Prod udf orum s/MacMessenger/ 

When you first install Office, it asks if you want to be part 
of the Customer Experience Improvement Program (aka CEIP) 
which gives Office ptTmission to peritidicaily send statistical data 
back to Microsoft about how the prcxlucts are used. No personal 
information Is collected. This is very helpful to Micrasoft, if you 
are game. (The default is off, so you would need to turn it on.) 

Finally, Microsoft uses Microsoft Error Reporting (MERP on 
the Mac, and Watson For Windows), which is for real time error 
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reporting. Like Apple’s reporter for Mac OS X, this is an 
excellent way to quickly send information that is machine 
generated about the problem that you are experiencing. 

Statistical Benefits 

What all the larger organizations have in dieir error 
reporting is the ability to gather significance statisdcally from 
the error reports. For example, diere are patterns to problems, 
and the bug reports are done in a way that Microsoft (and 
presumably Apple), can compare two l3ug reports and see if 
they are the same issue or not. Once that happens, diey can 
determine whether an issue has widespread impact, or is 
localized to just a few users. In tJlher words, it helps them to 
prioritize which things need to be fixed first. 

Anodier example is that they can see diat certain problems 
may be t>n specific OS versions, categories of machines, or even 
specific models of machines. This not only helps in 
understanding how to fix the bug, but is also may give insight 
that ifs not a vendors bug. 

For example, in the next maintenance release of Leopard, 
Apple is rumored to be fixing a large number of items. 
Microsoft may be looking at bug reports for an issue, and may 
very well find that the problem in question is not one with 
Office, but with the Operating System instead. Of course, the 
same thing could happen in die opposite direction where Apple 
receives bug reports, and finds diat its a tliird party. 

Near Term Expectations 

Leopards next update wiU likely be the one dial fixes so 
much stuff that those that have been waiting, should now move 
forward. Naiurally, Microsoft Ls working on updates for Office 
2008 as W'ell, pre.sumably called SPl (Service Pack 1, if they 
hold true to naming conventions). These will likely to fix many 
issues that widespread distribution saw, but MacTech may not 
have with the benchmarks on clean machines. 

Why is this expected? Because both these companies have 
mechanisms in place to listen to customer experiences, 
problems, and bugs, research them dowm through .statistical and 
other comparisons, and rank their priority accordingly. 

But, all of that doe.sn’l work unless we, the technical 
community, make sure to use the reporting mechanisms as 
much as possible. 
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Introduction 


This article is gning to 
introduce you to Dashcode, an 
application -actually, an fDE- for 
creating and debugging Dashboard 
Widgets. You will also learn other 
essential information about 
installing and packaging Widgets, 
the Info.plist file and its keys as 
well as the Property List Editor. 

What is Dashcode? 


r\ 



Dashcode 

Version 1,0 (41) 

C Apple Computer, Ire*. 2006 



Dashcode™ 

Vtnion LO UMj 

Cwvrlflfrt D Zffi)6-Z(3(17 Apple JHc. 
All Tights fESfifved. 



Dashcode is a development Figure 1: 

environment, a GUI application, for Qf 

creating Widgets. Although it was 
exposed prior to its official release* 

we now know it is a reality. With the relea*se of Mac OS X 10*5 
and Xcode 3, Dashcode was officially released to end users. 

You should use the Xcode Tools installer to install 
Dashcode. After installation, you will find Dashcode in 
/Deielol)er/Al}piicaHo}%s/, 

Figure 1 shows the Alx>ut Dashctxie window inhirmation 
of both the unofficial-this beta expired on July 15th, 2007-and 
official versions. Both versions are numbered as 1.0! 

When to use Dashcode 

• Dashcode is a great tool but it cannot solve every problem 
efficiently. Knowing its strengths and weaknesses will help 
you use it effectively. You can also judge when, and when 
not to use it. 

• Dashcode is wonderful for automatically creating template 
files that you can edit, as you wish, wlien creating your cmn 
Dashboard Widgets. This is a great time saver! 

• Dashcode Is perfect lor debugging Widgets because it allows 
you to dynamically view your errors. Another great time 
saver when tmubleshouiing Dashboard Widgets! 


The "About Dashcode" information window 
unofficial and official Dashcode versions 


* Dashcode is usefiii for quickly creating Info.plist files* 

* Dashcode is very efficient when creating Widget widi 
localization. 

When not to use Dashcode 

I'll first admit a little bias: I personally do not, for the most 
part, like integrated programming environments, as 1 prefer to 
write my own code using my editor of choice. Although 
Dashcode came into action wMe 1 was writing my eBook, 1 
was very happy that 1 wrote most of the book’s code using an 
editor without using code that was automatically created by a 
tool. I dislike tfie fact that most programming environments 
style code as tliey prefer, where they prefer and, sometimes, 
witiiout letting the programmer decide essential details. 

My advice is that when you are learning a new' 
programming paradigm or technique, it is generally better to 
first write all your code by hand, and, as you become more 
experienced, to use such a tool. Through exerience, you can 
differentiate good code from bad ccxle, debug your code and 
make changes to the created code. 
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1 "RAM Hog" Results | 

RAM Configuration 

Stock 

2.0GB 

2048MB (2x 1024) 
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4.0GB 

4098MB (2x2048) 

MacBook Pro 15" (Mid/Late 2007) 

2.2 GHz Core 2 Duo (4MB L2 Cache) 

297,68 seconds 

Only 

84.97 

secondsi 

m 

MacBook Pro IS" (Early 2008) 

2.6 GHz Core 2 Duo (6MB L2 Cache) 

250.28 seconds 

Only 

76.50 

seconds! 
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Also, although Dashcode allows the use of Widget plug¬ 
ins, it cannot create Widget plugdns. You still need Xcode when 
programming Widget plug-ins. 

If you create a Widget using Dashcode, your Widget will 
look similar to other Widgets created using Dashcode-so 
originality is not easily achieved. 

How to package a Widget 

Let us say that you have a minimal Widget, called 
HelloWorld-it just displays the “Hello World!” message inside 
Dashboard. This Widget only needs four files named 
Hello World, htmf Info.plisi, Default.png and Icon.png. The last 
three filenames are fixed, whereas the first one can be anything 
you want-provided that it is an HTML file-l)ut its filename 
should be declared inside the Info.plist file. 

So, you have your files and you want to actually “create 
and use” your Widget. 

All you have to do now is put all the above files in the same 
directory. It Ls a good practice to use an explanatory direaory 
name. 1 C'alled mine HelloWorld. The next action is io go to the 
parent directory of the HelloWorld directory in order to rename 
it The new name will be HelloworkLwdgt. A message asking 
you if yc3u are sure about the new extension will appear and 
after an.swering yes you will get your first Widget ready for 
installation! The sign that you have successfully changed the 
directory type is that the directory icon will c:hange. 

Most of the time, it is good practice to have a copy of your 
Widgets as plain directories that contain the relevant files. It 
makes watching and changing the files easier as well as scning 
as a backup copy, figure 2 shows the Command-I (using the 
Finder) infonnation for a Widget bundle and the relevant plain 
directory structure, respectively. 
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Figure 2: The Ctnd-f I output for the HelloWorld.wdgt 
bundle and the HelloWorld directory 


Installing a Widget 

There are two places tliat you can install a Dashlxjard 
Widget. Also, there are two ways for installing a Widget, 

The first place for installing a Widget is in the 
/Library/Widgets directory. The WidgeLs that are located there 
are system wide, which means that everyone in the same 
Tiger/Leopard system can use iliem. The second place is inside 
die Library/Widgets directory that is located in each user’s 
home directory. Your home directory is usually called 
/Users/yt )U r_u ser_name, 

Tile first way to install a Dashbt)ard Widget is to double 
dick on it, Mac OS X will ask you if you want to install it and 
if you answer “yes", it will put the Widget inside the 
Library/Widgets directory on your home directory. This 
directory is also called -given the shorthand notation- 
-/Library/Widgets, with the tilde signifying your home directory 
in the UNIX jargon, Tlii.s means that other users of the system 
cannot automatically use your Widget, 

When double clicking a Widget, a tiiessage will ask you if 
you want to install it (this happens lor security rea,sons). By 
pre,ssing Hnsrall”, you will go inside Dashbt>ard and see Figure 3 


HelloWorld 


Hello, Worid! 


L P elete ^ L P 3 


Figure 3: Trying to install the HelloWorld! Widget 


If you answer “Keep" the Widget is going to be installed 
inside your home directory -/Library/Widgets. If you answer 
“Delete”, the Widget is going to be placed in tlie Trash. 

The second way is to manually copy the Widget bundle 
inside your preferred directory. You can still put in inside the 
Library/Widgets directory in your home directory (a,k.a. 
-/Lihrary/Widgets) but you can also install it manually in 
/Library/Widgets, provided that you have the required 
administrator privileges. 

The Info.plist file and its keys 

Tile Info.plist file is the property list file for every 
Dashboard Widget that is a XML file. Its filename is mandatory 
as well as its presence inside each Widget directory (or bundle 
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if you prefer). The [nfo^plist file contains some keys, five of 
them being obligatory, Otlier keys may or may not be defined 
depending on the resources that are needed to be utilized by 
the Widget. 

The mandatory property list keys are the following: 
CFBundleName, CFBundleDisplayName, CFBundleldentifier, 
CFBiindieVersion and MainHTML. All of them are of string type, 
'Hie required properties are displayed in bold type in this list: 
AllowFileAccessOutsideOfWidget: lliis key defmes if the 
Widget is allowed to access tlie file system that is outside tlie 
Widget's directory. Access is limited l^y tlie permissions of 
the user tliat runs the Widget. 

AllowFullAccess: Tilts key defines if die Widget needs access to 
file system, Web Kit and standard browser plug-ins, Java 
appleLs, network resources, and cxjmmand-line utilities, 
AllowIntemetPlugins: It define.s if the Widget requires access to 
Web Kit and standard browser plug-ins. 

Allowjava: It defines if the Dashboard Widget needs access to 
Java applets, 

AllowNetw'orkAccess: Tliis key defines if the Widget needs 
access to resources that are no! file-based, including 
network resources. 

AllowSystem: This key defines that the Widget requires access 
to command line tools using the Widget script object. 
BackwardsCompatihleCiassLookup: It defines if die W^idget uses 
the JavaScript clas,ses tltat are provided by Apple in a 
backward compatible way. 

CloseBoxlnsetX: It defines die offset for the location of the 


Dashboard Widget close box on the x-axis. Allowed values 
are between 0 and 100, 

CloseBoxlnsetY: It defines the offset for the location of the 
Dashboard Widget close box on the y-axis. Allowed values 
are bemeen 0 ^md 100. 

Font: It defmes an array of strings. Each string denotes the name 
of a font that is located inside the Widgef s root directory. 

Height: It is an optional number that denotes the heiglit of the 
Widget in pixels. 

Width: it is an opdonal number that denotes the width of die 
Widget in pbcels, 

MainHTML: Tlie relative path to the Widgefs main HTML file. If 
this is wrong, chances are die Widget is not going to work 
at all! 

CFBundleldentifier: This Ls the unique" name of the Widget. 
Apple's Widgets are named 

com,apple.widget,_widgetname_ ). Other Widgets are 
named similarly. 

CFBundleName: A string that defines the name of the Widget, 
The string must match the name of the Widget directory on 
disk without the ,wdgt file extension, 

CFBundleDisplayName; A string that defines the text that is 
going to be displayed in the Widget bar and the Finder, 

CFBundieVersion: 'fliis is a String that defines the exact build 
version of die Widget, 

Flugin: It is a string dial defines the name of the custom plug¬ 
in diat is used by die Widget. Piug-ins are located inside the 
Widgefs directory and are compiled Objective-C code. 
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The list is big but, as you already know, only five property 
list keys are mandatory. Most of them are optional, depending 
on what your Widget is planning to do. It is a very important 
task to define tliem the right w'ay-both for security and 
functionality reasons. 

It is important to remember that if your Widget does not 
work as expected or does not even show on Dashboard, the 
first thing to look is if the required property list keys are 
properly and correctly defined. It is a common mistake that can 
cause a lot of lost time in de[3Ugging. 

The Property List Editor 

The Property List Editor is for creating, altering and 
viewing an Info.plist file (and other .plisi files.) which is a plain 
text file in XML format. Tlie main difference from a text editor 
like vi, emacs, or mmo is that Property List Editor is a GUI 
application-some people find it easier and less error prone to 
u.se a GUI application than a traditional text editor. On die other 
Ivand, plain text editing is (quicker and can be automated using 
a scripting language. 

Be careful with the editor you use, as not every application 
saves in a plain text formal. Be aware of software such as 
Microsoft Word for Mac or Macromedia (now Adobe) 
Dreamweaver to create a pure text file. 

First, let me present you an example Info.plist file in XML 
format: 

<7xtnl version='T.O'" encodings""tfTF'8’*?> 

<ID0GTYPE pllst PUBLIC " //Apple CampUter//DTD PLIST 
1.0//EN" 

“http: //www.a.pple. tom/DTDs/PropertyList -1.0.dtd"> 

<pllat versloti='*l. 

<dict> 

<key>All owSy s t eni< /key > 

<true/> 

< key)CPBuudle Disp1ayName </k e y > 

< a t r 1 ti g >MakeTa r< / s t r ing> 

<key>CFBundleIdentifler</key> 

< St ring>coTii .iBtsouk. wl dget, tqaketar </St ring) 

<key)C FBun d1eKame </key > 

<Btriiig>Make Tar Widget</string> 


< key> CFBundle S b or t V er sio nS t ring C/k ey > 

<string>l. l</strlr3g> 

<key>CPBuad1eVersi 0 n</key> 

<strliig>l ♦ l</atring> 

<key>CloseBoxInsetX</key> 

<integer>45</lnteger> 

<key>C1 0 seBoxInsetY</key> 

^integer)35</integer) 

<key>MainHm</key> 

<string>MakeTar.html</String) 

</dict> 

</plist> 

Tile same Info.plist file in Property List Editor can lx? .seen 
in Figure 4. 






New Sibling 

Delete 



i Property List 

1 Clas 


▼ Root Di< 

Allow System 0c 

Figure 4: A Property List Editor example 


Apart from the preamble of the Info.plist file, which is 
hidden in Property List Editor, the rest of the information is easy 
to be seen or altered. If you press tlie “Dump” button in the 
upper right comer, yt)U will gel the Info.plist in plain text 
formait, including the preamble. 

If you ask my tjpinion, I prefer tlie plain text version of the 
Info.plist file :-) I rarely use the Property List Editor. 

A Dashcode example 

This part of the article will present you with a brief 
Dashcode example. 1 am going to create a complete Widget, 


Choose a template for your widget: 



Apple's available Widget templates 
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for illustrating the Dashcode usage, Tn a previous article, I 
created a Widget that reads the HSS feed from MacTech.com 
and displays it in a Widget. 1 decided to create the same 
Widget using Dashcode, Please note that there is an existing 
RSS feed Widget template inside Dashcode that greatly 
simplifies the process. 

Figure 4 shows the look of the Widget created in 
Dashcode. You can also dynamically change the length of the 
presented articles (using the backside of the Widget)-! should 
say that 1 am pretty impressed as it only took me 10 minutes 
to create it! It is also impressive that I did not write a single 
line of code! 
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Figure 5: A Widget that reads RSS feed from 
MacTech.com 

Wlien launched, Dashcode presents a theme chooser. 
There are two RSS feed types: a generic RSS list type, and a 
“Daily Feed” template. The “Daily Feed” template shows only 
the current item from die RSS feed. I cho.se the “RSS” template 
for this example (see belowO, 

Once chosen, Dashcode displays the main window with a 
graphical representation of the widget showing. By choosing 
“Widget Attributes” in the navigation bar on the left of the 
window, you can access and edit all properties of the widget. 
Figure 6 shows this screen, including the source for the RSS 
feed as well as some of the keys in the Info.plist file, the Widget 
identifier, its version number, etc. You can even add localization 
to your Widget. 
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Ours does. 


Imagine an email program that was smart 
enough to observe and learn how you handle 
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from your inbox for a few days or weeks, so that 
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to deal with it? What if this program had an 
amazing junk mail filter that would leave your 
inbox devoid of spam? What if this program 
was as familiar and easy to use as Apple Mail? 
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chores far easier. And since this is a 
current-generation application, it supports 
major email protocols including POP, IMAP, 
SMTP and SSL. It also runs natively on the 
latest Macintosh computers and OS X 
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Check out the details at www.outspring.com. 
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Figure 6: Setting attributes from within Dashcode 

For more complex widgets, or just for a little hand-holding, 
you can also folk>w the ‘‘WorkOow Steps" portion of the 
window to step through the process. If an attribute is required, 
Dashcode lets you know with a "Required" badge. 


Workflow Steps 


Set attributes 

Provide an identifier and 
version number for your 
widget. 

Attributes 

? Mark as Done 

v____ y 

For the RSS widget, only two attributes are required: the 
identifier, and feed property. The identifier differentiates one 
widget from another Typically, identifiers are specified in 
reverse domain notation. 

Identity 

SaiTipjeitSS 

Widget Identifier CQm.mtsouk.widgcusampiekSS _ _ 

Modified Monday 07 April ZOOS 17:24:19 Europe/Athens 


In this example, the identifier is 
com.mtsouk.widget.sampleRSS. The version number 
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helps DiLshbcxird to determine if youTe running the latest 
version oi a widget. The identifier and version fields 
correspcmd to Uie CFBu n diet den tifer and CFBundle Version in 
the widget's Info.plist file. 

The other required property is the FeedUKL and respective 
feed information. 


Propenies 
Fetid URL 
Show Articles 
Display 


feed : / / www .rti ac tech, com/ n e ws / mactech .rs s 
[ 10 most fecertt »-* j Within f Any date 

^ Show aitide date and tfnte Show new content 


Then, by going to the File menu and selecting ""Deploy 
Widget" (figure 10), you can export your Widget and have it as 
a separate object that you can distribute and install. After 
installing the Widget in Dashboard, it worked without 
problems. 
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Figure 10: Deploying a Widget from Dashcode 


I will also show you the list of the files that Dashcode 
creates at the root of the widget package using the UNIX Is -al 
command: 
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total 64 

drwxr-xrx 

13 mtsouk 

staff 

442 Apr 

7 17:36 


drwxr-xr-x 

24 mtsouk 

staff 

816 Apr 

7 17:36 


- rwr—r— 

1 mtsouk 

staff 

4329 Apr 

7 17:07 Default.png 

-rv-rw-r— 

1 mtsouk 

staff 

1196 Sep 

24 2007 

Icon,png 

drwxr-xr-x 

14 mtsouk 

staff 

476 Apr 

7 17:04 

Images 

-rw-rw-r- 

1 mtsouk 

staff 

S32 Apr 

7 17:36 

lufo.plist 

drwxr-xt-X 

9 mtsouk 

staff 

306 Apr 

7 17:04 

Parts 

- rw rw-1— 

1 mtsouk 

staff 

1340 Sep 

24 2007 


SafariStyle 

-rw-rw-r- 

.css 

1 mtsouk 

staff 

4084 Apr 

7 17:07 


SampleRSS.css 
-rw-rttf-r- 1 mtsouk 

staff 

3015 Apr 

7 17:36 


SaiapleRSS.htral 
-rw-rv-r— 1 mtsouk 

staff 

311S7 Apr 

7 17:04 


SampleRSS, j 
-rw-rw-r— 

s 

1 mtsouk 

staff 

295 Apr 

7 17:24 


attributes. 
drwxr-xrx 

js 

4 mtsouk 

staff 

136 Apr 

7 17:03 

en.Iproj 


'Iriie to my preference for hand coded widgets, HI point 
out that the Widget I created for processing the MacTech.com 
RSS feed for the previous article is a little bit smaller in size. 

Conclusions 

Creating Dashboard Widgets Is easy provided that you 
know some basic things and follow some principles. Apple 
provides many tools tliai will lie Ip you write Widgets. One of 
them, Dashcode, is a liandy tool provided diat you can 


understand its strengths and weaknesses. If you are an 
interinediate to experienced Widget programmer then it can 
save you time. If you are just starting Dashboard Widget 
programming then 1 would propose that you start programming 
Widgets without using Dashcode to truly learn the foundatioas 
of what goes into a widget. 
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Project History 

Since the project started over eight years ago various people 
have contributed to LBackup in one wiiy or smother. In 2007 the 
project was released under the GNU GPL and a website for the 
project was also established. 

If you had asked me what I tlioughi alxjiii backup ten years 
ago, I would prolxibly liave replied, 'It is an knportani but 
extremely Ixjiing topic''. However, my attitude towards backoip 
since tlien has dramatically changed. 

1 w'as put in charge of backups at work. Tlie company already 
had established a Irackup .system. They were using c-ommercial 
backup ,scjfTware to manage the data wiiich were copied to tapes 
by an expensive and extremely slow (by Uxkiy’s .standards) tape 
clrive unit. 1 had been tasked witli keeping the system ninning. 

Tlie Ixickmps were often running IxHiind schedule. Initially, I 
assumed this w^as due to die taf>e errors wliich would often greet 
me on Monday mornings. It ,slow1y dawned on me tliat the Uipe 
errors were not die only reason that 1 was perpetually playing 
backip catch-up. Tlie primary issue w'as actiuilly die limited 
amount of time di^a was availalile for die iTackup to run. kxiking 
through the logs, 1 cdcidated diat the backup w^uld often uike 
longer dian die time available for die backup lo mn. I wanted to 
find a solution to diis problem, hut diere were no inexpensive 
solutions reiidily av;iilable. This is w'liat inidally sparked my interest 
in backup teclinology. 

A ctJUple of years later, I enfr>lled at university. Initially, 1 ased 
die schcxil computers and the Ixickups trf my cxmiputer files were 
managed for me by die system administrators at the university. 

'Iliere were not enough computers in the labs at university 
iind the times which undeigniduatc^ were allow^ed aemss to the 
computer labs was strictly regulated. 

Luckily, just prior to starting university, I had lieen gifted a 
second-hand laptop. This wa^s a great gift and 1 conWnced myself 
dial working remotely from home wTiuld not only be more 
convenient, but also more productive. However, in reality, working 
remotely from home was intolerably slow^. Therefore, it was not 
Icmg until 1 had many unpottant documents stored locally on my 
laptop rather dian on the university computer system. 


Backing up diese locally stored files manually was na an 
attractive option. In addition, 1 did not want to return to die daily 
competition w'idi odier students for computer access. 

If s^)medling w^as to happen to my laptop imd was to I lase all 
my sclKX)lwork, I could fail multiple courses. Tlie danger of my 
situation w^as mnfoiced by die i-ecent memory of installing a new 
hard dri ve for the previoas owner of my laptop due to a liard drive 
failure. 

It was time to take action. I liegin researching various liackup 
.solutions that would protect my precious files, Tlie initial aim of tills 
project w'as not to build a backup system; it was to find an existing 
backup tcx)l diat was reliable, simple, unobtrusive and mast 
importantly inexpensive. 

After testing various backup systems 1 eventually, settled upon 
rsync\ I was deliglitcxl diat my imjxmni schoolwork w'as now 
Ixickc'd up. I liad no idea at die dme dial diis scTipt which had 
Ixen wiiipped up for testing was going to cwolve into LBackup. 

Not long after instilling and configuring die script on a few 
nxtehines, I realized them were some nenv' features which 1 
desperately required'on some of diese new^ setups. I manually 
added the new feature to each inslallatif)n as mquiretl After 
repc'ating dils process a few- dmes it Ix-c’ame clcxir that diere liad to 
be a Ixtier way. A more sensible appnjach would lie to separate 
die cxxle wliich perftirmed die Ixickup, from the configuration 
information which a^nlained the details of how to perform die 
Ixickup, on each individual niachine. 

I spoke to a friend whom 1 had met at university about die 
problem and together w^e w^irked out a solution. It was not long 
before an example configuration directtsry^ w^is included and the 
system liecame commonly referred to as LBackmp. 

Adding the configuration system meant that additional features 
could easily lx added as required. 

About LBackup 

LBackup is an open source backup tool. It relies on many 
other open source tools in order to ftincdon. 
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A basic LBackup configuration file often takes less than 10 
minutes to setup (excluding the time required for testing). Although 
the current version of LBackup is not yet as easy to setup as Time 
Machine, it Is cx>mpietely customizable. 

Below is a li-st of the key LBackup features as of version 
0,9.8q6. 

Designed for user data backup 
Full backup tree 

Encrypted l>ackups (Transport and Storage) 

Email reports 

Hand links (Saving Space) 

RSync bac:k-end (Reliable) 

Pre and post actions (such as mounting and un-mounting 
volumes) 

Network backup 
Automation 

All tliese features are documented in further detail on tlie LBackup 
website. 

Basic Backup Tutorial 

After completing this tutorial you should lixrve an idea of 
whether LBackup is right tor your needs. Thus tutorial aims to 
provide you with a feel for how LBackup works. This tutorial 
assumes you are mnning Mac OS 10.4.x or later and that you are 
familiar with using Mac OS X. 


Step (1): Caeate a new directory* on in the 
directory cnlled source. 

Step (2): Create another new directory in the /tlser^bared 
directory called destimtion. 

Step (3)^ Visit tlie LBackup web page and download the latest 
version of LBackup 

Step (4): Run the LBackup instalier and follow the on screen 
instructions. 

Step (5): Open the root directory on the system which you just 
installed LBackup. 

Step(6): Open the Ibackup directory within tlie root directory* 

Step (7): Copy the example_backiip_conflg directory into the 
/U^^r^hami diimory, 

Step (8): Rename die directory you copied in the previous step 
to lestingibackiip. 

Step O): Loc'ute the file called exampleJxi{±tip.conf vAihin the 
ieslhiglbackup directory. 

Step (10): Rename the exmnple_backup.cQnf file to 
tesUnglhackiip. conf. 

Step (11): Edit die configuratitsn file so it is die same as the 
lusting lielow^ 

ba ckupConf i giir a t i onVe r sIodt 1006 
useSSl^'*N0" 

s eudGrovlNo tlf Ic atioii=" MO" 
backupSou r ce=/Use r s/Shared/source 
backupDest“/Users/Shared/destination 
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log_fll^aiiie='’Test±ngLBacktip. log’* 
exclvides_filenarae=^cludes, txt 
iiiiniRotatlon3=S 

s sh_pe rmi t _st anda r d_r sy nc_ve r s i on=" YES " 

Step (12): Open a TerminaJ. 

Step (13): Type the following into the terminal and then press 
return, 

/liar/local/ sbin/Ibackup 

/Users/Shared/testinglbackup/teEtinglbackup.cotif 

Next you shcHild see something similar to the following as output 
on the terminal: 

Loading Backup Script Configuration Data,,, 

Checking for Pre Action Scripts... 

First Run Full Copy.,. 

Synchronizing,,, 

Number of files: 1 

Number of files transferred: 0 

Total file size: 0 bytes 

Total transferred file size: 0 bytes 

Literal data: 0 bytes 

Matched data: 0 bytes 

File list size: 62 

Total bytes sent: Ik 

Total bytes received: 20 

sent 74 bytes received 20 bytes 188,00 bytes/sec 


total size is 0 speedup is 0,00 

real 0m0.153s 
user 0m0.004s 
sys OraO.OISs 

Rotating Backups,,* 

Performing Atomic Swap... 

Checking for Post Action Scripts,.. 

Backup Conrpleted Successfully 

You have just configured and run LBackup. Check 
inside the destination directory you created in step (2) and 
you will see a new directory called Section.0. This directory 
contains the latest successful backup of the source directory 
which you created in step (1). 

Add some files or directories into the source directory. 
Then run LBackup again by following the instructions in 
Step (12) and Step (13)- There will now be two directories 
in the destination directory. One called Section.0 and one 
called Section. L if you open the latest backup directory 
{Section.0), then you should see a directory called source. If 
you open this source directory then any of the files and 
directories you placed in the backup directory should 

also be visible. 

If you would like to exclude files from being copied 
from the source directory to the destination directory then 
edit the excludesAxt file located within the testlbackup? 
directory which is located within the /Users/Sbared 
directory, 
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MetaData Preservation 

On Mac OS X systems, many file system objects have 
associated metadata. The extended file system (HFS+) supports 
the storage of this metadata. It is important that you check your 
backups and ensure chat any required metadata is being 
preserved before you accept any backup system as a suitable 
backup solution. 

The compilation options of rsync and the run time flags 
specified by LBackup determine which metadata is preserved 
when you run LBackup. 

On a Mac OS X systems, the user who executes the backup 
is also an important factor in preserving metadata. For example, 
if your backup policy states that preserving the POSTX (portable 
operating system interface) owner and groups of files and 
directories is important. Tlien you should run the backup and 
check that this data has in fact been preserved. 

The ownerships are a special case when performing a 
backup on Mac OS X systems. This is because the only user 
who is capable of the modifying the owner of existing file 
system objects is root. Therefore, if you are backing up fiJes tliat 
belong to various users, it is important to run LBackup as root 
so this metadata is able to be presented. For example, T you 
were to run tlie backup as user witli UID (user identifier) 508 
then all the files which are backed up will have the POSIX 
owner set to 50B regardless of whetlier the file system object 
being backed up had this IJID, 


Restoring a File or Directory 

To restore a file or directory to the desktop simply locate 
the file or directory you would like to restore within the backup 
destination directory and tlien copy this file or directory to the 
desktop. 

When restoring a file or directory, metadata preserv^ation 
may still be important. For example, if you were going to 
restore a network home directory, tlien it would be advisable to 
copy (restore) the directory as root. This will preserve the 
permissions of the NHD and its contents. 

User Access to Backups 

Because LBackup stores the backup(s) in a file tree rather 
than in an archive, it is possible to configure tlie backup 
directory so it is available via the network, as a read only share 
point. Such a setup will aEow users to perform file level 
restores, without needing to contact the backup operator. 

Why is Lbackup Open Source? 

In 2007, it was decided that LBackup should be available 
to anyone and everyone for free. One motivadon behind the 
decision was tliat 1 and many <jf the companies I was working 
with preferred t(} use an open sc^urce backup solution when 
available and appropriate. Another reason behind the open- 
source move was that rsync had also been released under the 
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GNU GPL and as such this was an obvious license to release 
LBackup under. However, the most important reason for open 
sourcing the project was to ensure that other people would 
have a tool which could be quickly and easily modified to meet 
their c>wn specific needs. 

Es-sentially this means that il' you add a feature, dien 
everyone else using LBackup also l>enefiis from your work and 
vice versa. Open source development makes sense on many 
different levels for this kind of project. 

Why the Crazy Version 
Numbers? 

I have l>een using LBackup at home for more than eight 
years and at work for more than lour years. A goal of a "1.0'’ 
release is a GUI which will allow users to create a basic 
LBackup configuration. 

The future of LBackup 

I would like to see a dean up of the code. It is nothing a 
little re-factoring will not fix. I am sure tliis will happen at some 
stage in die near future. 

In addition to a general code dean up, there are some 
other new features listed below which I believe people would 
lind handy: 

A GUI offering even basic backup setup options. 

Some bundled scripts for shutting down and .starting up 

various databases. 


An installer or some sort of automated setup of network 
backup dient(s). 

A system for handling network backup clients that come 
onto and off the network* 

(1 have heard that TimeCapsule and Time Machine does a 
pretty good job under 10.5) 

Some bundled scripts for performing various database 
dumps. 

A bundled script to handle backup locking 

A system to make the setup of encrypted backups a little 

easier. 

A pre- or post- script which performs a malware scan of 
the client or client data. 

Pcxssihle integration with Link-Backup (which looks like an 
interesting backup system!). 

There are of course many more features that other people 
are sure to need and may even develop. The LBackup team is 
always open to ideas. If you feel like adding a feature or just 
tidying-up some code tlien please consider j{iining the LBackup 
team, tiiiis making the world a better place. 

LBackup Support 

If you require assistance with the setup or integration of 
LBackup, then Lucid Information Systems is available to help. 
Lucid offers on-siie support for LBackup in selected regions. 
Visit their web page for contact details. 



Electronics Repairs & Upgrades 


Overnight • Nationwide 

* Local Pickup & Delivery 

• Fast Friendly Service 



■ 9000-1-Local Dropoff Locations 



1^888-64-RESTQRE 
(1-888-647-3786) 
ji- Bam - 5pm PT M - F 

techrestore.com 





Put A Smile On Your Client’s Face 
By Referring Them To The Nation's 
Most Recommended Repair Service 

Laptop • iPod • Mac mini • Apple TV 
X-Box 360 • PSP • PS3 • Wit • DS 

• Affiliate Commissions 

• Reseller Accounts 

• Volume Parts Sales 

*. Blind Drop Shipments 

• Transparent Back-End Repairs 

• Customer Referral Numbers 


America’s Most Trusted 
Repair Service Offers 
Over SOOO Local Drop Off 
Locations With America’s 
Most Trusted Carrier 

FecExKinko's»s|( 

•Of f i ro a nd-Print Center 

Shop for Mac Laptops, 
Apple TVs & Mobile 
Electronics Accessaries 


Outsource Repairs, 
Increase Profits! 

vvvvw.techrestore.com /reseller 


j Ti&Git ©^stere 


Fadfx aarvlfcd maite used by parmiaaieini 









ETWORK 

Eunning So Slow? 

Time For A Pop Quiz 



Pop Quiz 

Choose the best answer: 

If my network is running too 
slow, what should I do? 

A) Continue playing with the toys 
I have, and hope it goes away, 

B) Spend $30,000 to 
$70,000 on Xsan, 

C) Call Small Tree for a network 
solution under $7,000. 
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Share Easier 
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To find out how Small Tree saved Dakota Video & Post Production over 
$20,000 on the perfect networking solution go to 
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LBackup Pre and Post Scripts 

LBackup supports pre and post scripts. This per- 
configuration feature is useful, if you won Id like to perform 
certain actions before or after a backup. 

The LBackup scripting sub-system open.s up a great deal 
of flexibility to tliose who are comfortable with programming. 
In addition LBackup ships with a variety of example scripts. 
The example pre and post scripts offer a way for you to get 
started quickly wath the LBackup scripting sulasystem. 

The pre and post action examples may be found in the 
LBackup examplejjackupxonfig directory. If you open the 
resources directory and then open the example-scripts 
directory you will be able to browse though the example 
scripts. 

One of the example scripts for Mac OS X users, allows 
LBackup to perform a push backup via SSH to an encrypted 
disk image. This script requires that you have installed 
MacFUSh and the MachUSE SSH File System module. This pre 
script will mount the directory of a remote machine via SSH. 
'Lhen it will proceed to mount an encrypted disk image that 
may be configiEred as the backup destination for this LBackup 
configuration. 

There are also associated post scripts to unmount tlie 
encrypted disk image and the SSH nitrunt point. 

LBackup also ships vvitli a variety of scripts to handle 
local drives and image files, With regards to the LBackup 
scripting interface, your tmaginalion is the limit. 

The LBackup scripting subsystem and the bundled 
scripts allows the configuration of redundant encrypted 
backups for a single data source. This way should .s<)nie!hing 
happen to one of your encrypted backups, your data should 
still be safe in one of the other encrypted redundant backups. 

More Scripting 

LBackup is command line and configuration file driven. 
Therefore, it is possible to build controi systems which waap 
around or extend LBackup. 

For example you may want to create backup chains or 
integrate LBackup with third parry (or your cmn) analysis and 
monitoring tools. 

Documentation and 
Development 

The LBackup development and documentation is open 
for editing. Provided this is not abused, the intention is to 
keep it this way. 

This means you are able to look into the future of 
LBackup and even express your opinion wath regards 
development decisions and directions., 

In addition, you have the ability to fix any spelling or 
grammatical errors you may find within the documentation. 
You may even end up adding some pages on how to perform 
some sort of special backup routine using LBackup, 


Conclusions 

Let your backup policy dictate your requirements. Then find 
a system that is a gotxl fit. Al.so, tiy^ different backup systems and 
see w^hich system is the best for you and your requirements. 

You may find that you end up u.sing more th£in one backup 
sy,stem. For example, one system may not cover all of your 
rec|uirements or you may find that one system will wwk better in 
certain situations, while anotlier will work better in other 
situations. 

Have a look at the LBackup web page and screen casts and 
then give it a try. 

Other Notable Free Backup Tools 
For Mac OS X 

If you are looking for a free backup tool for use w ith Mac OS 
X then the foUowang free tools are defiantly w^orth investigating, 
tfarlxjn Copy Cloner 
rdiiT-hackiip 
rsync 

Time Machine (requires 10.5 or later.) 

Rsnapshot 

Link-Backup 

Related Links 

LBacku p : http: / /www. lucid systems, org / backup 
CiNII GPL ; http://www.gnu.org/copyleFt/gpl.htTnl 
Carlson Copy Cloner ; 
http://www.bombich.com/soflware/ccc. html 

rdiff-biickup : http://www.nongnu.org/rdiff-backup/ 
rsync : http://samba.anu.edu.au/rsync/ 

Rsnapshot: http://www.rsnapshot.org/ 

Time Machine : 

http: //www.opple. com/macosx/ faatu res/Ti me Mach i ne. html 
TinieCapsule : http://www.appte.com/timecapsule/ 
Link-Backu p : http: //www. scoftlu. com / Content/Un k- 
Bockup.html 

MacFLlSE : http://code.google.eom/p/macfuse/ 

MacFUSE SSiWS : 

http://code, google .com/ p/macfuse/wiki/MACFUSE_FS_SSHFS 
Lucid Inlbrmation Systems ; http://www, lucidsysfems.org 

\\\[ 
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Henri h not the rndy one who has loaded data rnito a computer and has 
then later been omAle to retrieve tins data. However^ m spite these 
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store various c^fal mformation. More recently he has made an effort to 
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various ^f(d data pratectian systems. 
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MacTech Salutes the 

2008 

Apple Design Award 

Winners 

MacTech Mogazine would like to salute the winners of this year's Apple Design Awards. Presented at WWDC 2008, these winners represent 

the best ofthe best ^ really cool concepts that take advantage of all thot 05 X has to offer. 


Winners by Category 



Best Mac OS X Leopard Application ....... 

. ScreenFlow 1.1.1.. 


Runner-Up .... 

Bee Docs' Timeline 3D Edition 2.1 . 

.. . . , Bee Dcx:nments, inc. 

Best Mac OS X Leopard Graphics 



and Medio Application.... 

. ScreenFlow 1.1.1. 

... Vara Software Limited 

Runner-Up ... . . , 

. FotoMagico 2.2 . 


Best New Mac OS X Leopard Game. 

. Guitar Hero III: Legends of Rock 1.1_ 

___Aspyr Medio, Inc. 

Ri/nner-Up.... 

. Commond & Conquer 3 Tiberlum Wars 

}.09 .f/ectron/c Arts (nc. 

Best Mac OS X Leopord User Experience ... 

. Macnification 1.0.. 

.. Orbicule BVBA 

Runner-Up . , ..... 

, Checkout 2.1 . 

.Wercit BV 

Best Mac OS X Leopard Student Product_ 

. Squirrel (alpha)... 


Runner-Up .. 

.Flow lO.I . 

. Brian Amerlge 

Best iPhone Web Application .. 

. Remember The Milk for iPhone & iPod touch 1.0..... Remember The Milk 

Runner-Up: .... 

. AP Mobile News Network LO . 

.The Associated Press 

Best iPhone Game.. 

. Enigmo 1.0.. 


Best iPhone Healthcare & Fitness Application 

. MIM 1.0 (alpha). 


Best iPhone Social Networking Application.. 

. Twitterrific 1.0 (beta). 


Best iPhone Entertainment Application. 

. AOL Radio 1.0.. 

.AOL LLC 

Best iPhone Productivity Application ....... 

. OmniFocus 1.0 (pre-releose)...... 


Runners-Up 




FotoMagico ^ 

Your audience will 

never fall asleep again, 





Turn your pictures into a story 
with the award-winning 
photo presentation software 
for professional photographers. 

Download free demo now! 
boinx.com/fotomagico 
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Checkout 

Get a Mac. Start a Store. 


Chijclcout \% the powerful, affond^blq 
point of sale sofution for the Mac 
Use Checkout to make sales, accept 
payments, view reports and print 
invoices and receipts. Install the free 
30-day trial and start selling within 
fifteen minutes. 


www.checkoutapp.CDm 
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Mobile News Network eOWEACD HV 


News 
at your 
fingertips 

> Gat news from local sources 


> View rich photo and video galleries 

> Share stories with friends 


www.apnews .com 
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Screen Flow 

Professional Screencasting Studio 


n ScreenFtow is the best screen capture application on any 
platform. If I didn't have a Mac Pd buy one )ust to use ill 

- Leo Laporte 



Record and instantly edit everything: 
Desktop, video camera, microphone, computer audio. 
Export for the web. 


Download a dertto from http y/www.varasoftware.com/screenflow 
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Winners 



organize, edit, analyze and 
annotate microscopic images 


Apple Design Award 


. _ Orbicule = « 

Mac'^ificanon 


macnification.com 






1.642,05 


^OlVf 


^ *'»®free 
^^nto ^ 

Squirrel 

Personal Finance Application 


Finance management with style 

Squirrel helpi you crack ,v\d pi,-vi] your finances with cMse. It \\.n »ill 
ilti? pow<?i'ful features you (teed in a boaucifutJ artd gorgi^ous nttcirfriccv 


/ Gorgeous interface 
/ Animated ^ PDF reports 
/ Budgets 


/ Smart folders 
/ Online banking 


www.squirrelapp.com 


|H Nac OS X Leopard only 
J Q$ 'Or Intel Mac recommended 

m 

9 Visit www.squtrrdapp.com 




remember 

the 


For iPhone and iPod Touch 


www.rememberthemilk.com 


The best way 
to manage your tasks 

Never forget the milk 
(or anything else) again. 
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MIM 



' Appjes8«d, Johriny 


MIM is 

on the move! 


MIMvista presents 
multi'inodality imaging 
on the iPhone'" and iPod 
touch. 


Visit www.mimvista.com 
for details. 


contouring * cardiac * fusion ■ neuro * connectivity 
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Omni Focus 

FOR iPhone 


Bringing task management to your fingertips: 

OmniFocus. 

A native, location'Sware iPhone application with five, 
automatic sync and custom action lists based on your whereabouts. 

Apple Design Awards 2008 Winner 
Best iPhone Productivity Appucation 


Look for it on the App Store 


THEOMNI CROUP 


omnicroup.com/omnifocus/iphone 



,111 At«t ? iM PM 

Top Pop ^ 


Hello Radio. 




LibtM Of LOv« 

SfiK 4lKl 1>10 MlfSlE 
Fhoni Otiyircii MohOti 
P*Su(*:5CjUMDTRACKl 

ct 


350 + music and talk 
stations all waiting 
for you, for free. 




AOL Radio 

power&iiy CBS Radio 



Winner^ Apple Design Award 
Best iPhone EntfitlalrFment AppllcaHon 


aolradioxom 
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Twitterrific 

for iPhone’'^ and iPod TouchT*^ 


Follow family, friends, and others on the Twitter 
social network by answering one simple question: 

What are you doing? 

• Displays all recent posts, replies and direct messages 

• Single-hand interface design odjusts for left-handed users 

• Easily attach photos and location to any tweet 

• And much morel 


Learn more; http i//ico nfactory.com/twittefrifit: 
or look few' us in the App Store on your IPhone'■’! 


ic^factor' 
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Creating a Backup 

Design and document an effective 
backup system for your business 



by Joe Kissell 


The president of a company 1 once worked for was fond 
of bragging that even if the headquarters building burned 
down overnight, all the organization’s data would be safe 
and business could go on more or less as usual tomorrow. 
He slept soundly kn(}Wing that the company's computers 
were backed up daily and that a cunent set of data tapes 
was kept in a secure offsite location. Fortunately, the 
company never experienced a devastating data loss that put 
this sy.stem to the test, but at least someone had carefully 
thought through the matter of backups and prepared a 
disaster recovery plan. 

1 had to wonder, though, if all the company’s data was 
truly as safe as my boss thought. No one ever told me, an 
ordinary employee, how the backup system worked. Were 
the Mac and PC on my desk among the computers that w^ere 
backed up regularly? If so, how'—and how^ often? (1 was 
unaware of any backup software running on them.) What 
would I have liad to do T I needed to restore a lost file? Did 
the company’s IT people ever check to make sure the data 
on those tapes was really recoverable? 

These are just a few of the things that should be spelled 
out in a backup policy^a brief document titat describes, 
concisely and in plain English, how^ your organization deals 
with backups, Although it may be left to the IT staff to sort 
out the technical details and implement the policy, everyone 
in the organization who creates or uses digital data should 
know what the policy says or at least where to find it, 

Of CQur.se, if you’re talking about backing up a handful 
of Macs in yoitr home, you don’t need a pc 31 icy at all; you 
only need a plan, which could be as simple as ''Buy Time 
Capsule. Plug in. Activate on all Macs.” However, what w^orks 
well for individuals, families, and small offices doesn’t 
necessarily scale to larger businesses. 

In this article I discuss many of the considerations 
involved in creating a backup policy for your organization. 
The point of developing a formal policy is not merely to 


spell out what you already do, but to think through a 
number of important issues that are often overlooked. If 
your organization has a backup system in place already, 
working through a policy statement can reveal holes and 
shortcomings that shoitld he addressed. If you have no 
backups, a solid policy can serve as a guide to set up the 
right sort of system, saving Lime, money, and aggravation 
later on. 

Start on the Right Foot 

Let me be blunt: an awful lot of people—not c^nly 
technologically clueless executives but even otherwise savvy 
IT guys—"take a completely backward approach to backups. 
They learn about some nifty piece of hardware or softw^are, 
get it in their heads that it’s the answer to all their backup 
needs, and then try to design a plan around that toy This 
can be seriously bad news; your company can get stuck with 
completely inadequate backups despite using what appears 
to be the latest and greatest (or, at the other extreme, tried 
and true) technology. The much wiser approach is to decide 
first exactly what you want tt> accomplish, and then go find 
the tools that enable yoti to get that done. 

Needless to say, we don’t live in a perfect world, and 
any numt>er of situations might force you to make do with 
les,s-than-ideal hardware or software. Even if you know your 
hands are tied with, for example, a legacy hardware system 
and a tiny budget, 1 still recommend crafting your policy 
initially as though those limitations did not exist. By the time 
you’re done, you may discover a workaround. At the very 
least, you’ll be able to demonstrate a gap between what your 
company needs and w^hat you can provide. If you can show 
the Powers That Be how^ effective and crucial your ideal 
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poliq^ is and then point out the gaps between that and what 
you currently have, you never know—someone just might be 
able to authorize an infrastructure change or find more 
money to spend on solving the problem. 

With that said, let's look at the three major categories of 
information your backup policy should contain: backup 
procedure, media management, and data restoration. 
Although I go into some detail here about each aspect of 
your policy, keep in mind that we’re looking for a concise 
end result—a brief outline or maybe a dozen bullet points 
dial should fit on a single sheet of paper. 

Backup Procedure 

Your backup procedure encompasses several main 
poinCs: what data you back up, using what method(s), how 
often, and to what media. Each one of these matters involves 
a number of decisions. 

What Data Should You Back Up? 

Without a doubt, one of the most important things your 
backup policy should state is precisely which data is backed 
up. Some people would immediately say "all of it,” but thafs 
not necessarily a smart thing to do. As the amount of data 
you back up increases, so does the time it takes for each 
backup to run, as well as the amount of storage space 
needed—not to mention netwcjrk congestion. All of this may 
not be a big deal w hen you have lialF a dozen computers, but 


it’s a nightmare waiting to happen when you’re talking about 
hundreds or thousands. 

You probably do not need to back up the operating 
system and preinstalled applications for every single 
computer on your network. For one thing, this could result 
in massive duphcatlon of files (though admittedly, some 
backup software is smart enough not to store multiple 
identical copies of a given file). For another, it's probably 
unnecessary in that your IT department likely has 
preconfigured startup drives, or even spare computers, that 
could be used in the event of a serious disk failure. In most 
cases, it should be sufficient to back up individual user 
data—as in the user’s home folder {>n Mac OS X or Windows, 
or even a subset of that folder, depending on where and how 
your users store their data. If your network is set up in such 
a way that home folders are stored on a server, you may not 
need to hack up individual workstations at all. 

Users may have some files that should not be backed up 
for one reason or another—for example, Photoshop scratch 
files, caches, or personal files that just happen to live on a 
company machine. It’s helpful, therefore, to state explicitly in 
your policy not only what’s included in a backup, but also 
what’s excluded. Your policy might state that all files put in 
a designated “Do Not Back Up" folder will be omitted from 
backtips, or that MP3 files and photographs, regardless of 
their location, won’t be backed up (if iheyTe deemed to be 
irrelevant to your business). 
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The situation changes, though, when talking about 
servers rather than individual users' workstations. You very 
likely do want every single file on your servers to be backed 
up, assuming that the servers are crucial to the operation of 
your business and that only business-related files reside 
there. You may already have mirrored RAIDs in place to 
reduce the risk of downtime due to disk failure, but a RAID 
by itself is not the same thing as a backup. If you have a 
multi-drive mirror and you periodically swap out drives, then 
you do have some additional insurance against accidental 
fde changes or deletions. You may also want to create 
separate bootable duplicates of your servers' drives on a 
regular schedule, or simply include the server's drives in 
your regular archiving scheme. In any case, spell this all out 
in your backup policy. 

Be aware that, depending on the size, structure, nature, 
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period of time. Before .setting your backup policy in stone, 
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must be certain to include in your backups. 
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what Is Your Backup Method? 

When 1 say method" here, Tm referring to full versus 
incremental or differential backups. (Although "incrementar 
and '‘differential" mean different things to different people, 
one common usage is for a differential backup to contain all 
the data that changed since the last full backup, while an 
incrementai backup contains only the data that changed 
since the last update. Incremental backups run faster 
because they ctimain less data, but differential backups may 
be easier and quicker to restore, especially if you use tape 
drives.) Your policy should state under which circumstances 
one method or another is used. For example, you might 
specify that a full backup occurs once a month with 
incremental backups twice a day and differential backups 
once a week. If the method is different for servers than it is 
for workstations, say what those differences are. 

How Are Backups Scheduled? 

Your backup policy should state how frequently 
backups run, whether that’s several times a day, a couple of 
times per week, or whatever. Backups are often scheduled to 
run after hours, when they'll have the least impact on users’ 
work. Although you can't precisely stare how long a backup 
will take, you can say something like “Backups begin every 
morning at 2:00 a.m.” or "Backups run between midnight and 
6:00 every weekday morning." 

Increasingly, backup software that runs only on a fixed 
schedule is becoming "old school." Some backup software 
constantly watches For changes and copies new or altered 
data after a short delay (say, 15 minutes). Other software 
simply checks to make sure any given computer was backed 
up at least once within, for example, the last 24 hoyrS“ 
providing flexibility for users of laptops or other computers 
that aren't always available on the network. 
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Media Management 




Spetlnim Angsts 


One way or another, be sure your policy (and the 
software choices that you make as a result of it) can 
accommodate mobile users. If your policy states that 
backups of networked computers always and only occur at 
three in the morning, laptop users might never gel backed 
up. Explicitly state whether or not network backups will 
occur while users are outside the office—and if so, whether 
remote users have to do something special to make that 
possible (such as connecting to a VPN), 

What Media Do You Use? 

In most large organizations, high-capacity tape drives of 
one sort or another are taken for granted as a backup 
medium, often with an automated loading and retrieval 
system. That may indeed be the best choice for your 
business, but it’s not the only option. In particular, given the 
rapidly rising capacities and falling prices of hard drives, you 
may find that some sort of hard drive array is just as 
economical, while providing much faster performance, 
especially for restoring files (since the data can be read 
nonlinearly). Your written backup policy can perhaps be 
worded in a generic way to accommodate potential changes 
in the media you use, but think through the implications 
carefully For example, the schedule and means by which 
sets of backup media are rotated offsite might be 
different for a hard drive array than for a stack of tapes. 
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The next .section of your backup policy should discuss 
how your physical backup media is handled. This includes 
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Rotating Media 

All backup media is subject to failure—for any number 
of reasons. A smart backup policy assumes that a certain 
percentage of media will fail much sooner than it should. 
The usual way to deal with this unfortunate fact of life is 
with redundancy: have two, three, or more copies of each 
backup and rotate them on a regular basis. For example, if 
you’re backing up to tapes, you might have three complete 
sets, each of which contains a cc^mplete backup of all your 
systems. Use Set A c^n Monday, and then switch to Set B on 
Tuesday Set C on Wednesday, back to Set A on Thursday, 
and so on. When a set is not in active use, keep it stored 
offsite in a safe location (see “Offsite Storage,” ahead). 

Your backup policy, therefore, should specify not only 
how many sets of media you have but also how they’re 
rotated. Do you switch sets daily, weekly, or at some other 
Lnterx^al? At what time do the rotations occur? Who’s in 
charge of moving the media around? 

This may be a good time to mention media labeling as 
wtU. Because any number of people may (either now or in 
the future) have to deal with your backups, you should 
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develop a scheme for labeling physical media that makes it 
crystal clear what's on it. This should include, at minimum, 
a designation for the set to which it belongs, a number 
identifying its sequence within the set, and the date on 
which it was first used. For iastancej “Set Alpha, Tape 3i 
6/1/2008.’' Depending on how complex your backup system 
is and the sort of media you use, you may need more 
information too, but the key is to make it obvious to anyone 
who might be using the system what data is on what media. 

Dealing with Used Media 

Sooner or later, you 11 fill up whatever media you use for 
backups. If youVe backing up the computers for an entire 
university onto tapes, maybe this happens numerous times 
each day; if youTe backing up a few computers from a small 
office onto a high-capacity RAID, it might not happen for 
months or years. (Sure, there are ways of selectively erasing 
old data from your backups, leaving only more-recent copies 
of your files, but even so, the volume of backup data is 
bound to exceed your media’s capacity eventually.) In any 
case, your backup policy should specify exactly what 
happens when a storage device fills up. You have a few main 
choices: 

• Recycle: Erase the media and record over it. 

• Store: Hang onto the full media. 

• Destroy: Ditch the old media in a way that prevents 
anyone else from reading your backups. 

If you choose “store” or “destroy,” you 11 start over with new, 
blank media. Regardless of your choice, list the details. If 
you recycle media, how many times will you do that before 
storing or destroying it? Do you replace an entire set of 
media all at once (generally a good idea) or by the 
individual piece? How long will you store old media, and 
where? If and when you de.stroy old media, how will you do 
so seeurely? (And, just as a reminder: you may be legally 
obligated to maintain certain kinds of data for a number of 
years—be sure to check before destroying anything.) 

In addition, because media reliability decreases over 
time, you should plan for any media to “expire^ after a 
certain point—full or not. I wouldn’t trust a ten-year-old hard 
drive to store critical data, for example. How long you 
choose to trust your media will depend on your personal 
experience, the manufacturer's MTBF (mean time between 
failures) ratings, educated guesses, your budget, and so on. 
However you determine the schedule, do plan to replace 
your media at regular intervals. 

Offsite Storage 

Remember my boss, the guy who wasn’t worried about 
the building burning down? You, the person designing your 
business’s backup policy, should definitely worry about that! 
It’s all well and good to keep backup media in a fireproof 
safe or other secure location onsite, but you must also have 
at least one copy (and preferably more than one) stored in 
another building. As unlikely as it may be, something could 
happen—theft, espionage, earthquake, terrorist attack, 
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whatever—that destroys all your backups if they’re kept in a 
single location. Don’t take any chances. You already 
specified that you have rnore than one set of media in 
rotation, so designate a safe offsite location to store media 
that’s not actively in use, as well as a system for .shuttling 
media back and forth. Needless to say, you don’t need to 
share the precise location of your offsite backups with every 
employee in your company, but you should make sure that 
several trustworthy people know it, in case something 
happens to you. 

Encryption 

Let’s take for granted that your backups contain 
valuable, confidential data about your business that should 
not fall into anyone else’s hands. It could be that your server 
room is highly secure, but as soon as you take backup media 
offsite, it becomes vulnerable—especially while in transit. 
And even if you employ armed guards and armored cars for 
transport, there’s always the chance that a nosy or 
disgruntled employee with access to your backup equipment 
could poke around in your backup data. So I strongly 
recommend specifying in your backup policy that all 
backups will be encrypted, and I leave it to yc^u to figure out 
what method of encryption meets your organization's needs 
the best. 

Encrypted data is useless unless someone knows the 
pass phrase. As with any important password, you have to 
strike a balance in security. If the system administrator is the 
only one who knows the pass phrase and gets hit by a bus, 
your business will be in trouble. So carefully choose a small 
number of people wholl be imsted to know how to decrypt 
your backups if the need arises. 

Data Restoration 

Backups are of no use whatsoever if you can’t restore 
your data when you need It. Unfortunately, restoration is 
usually the part of a backup policy that gels the least 
attention. Give careful thought to all the differeni scenarios 
for restoring data that might arise, and make sure your policy 
spells out the following information. 

Who Can Restore Files? 

In must business situations, only an IT person can 
restore backed-up files, since they reside on a .secure server 
and since it would be all too easy for a user to mistakenly 
overwTite good files with backups. The downside, of course, 
is that restoration can be inconvenient and time-con,suming 
for the user as well as for the IT staff. You could choose to 
implement a backup system in which individual users can 
directly restore files, if you he aware of the trade-offs and 
willing to live with them. 

If restoring backups is the responsibility of a network 
administrator, your backup policy should state exactly who 
has tills capability, and how to reach the person or 
department in charge. It should further specify the hours and 


days during which it’s po.ssible to restore backups and what 
to do in case of an off-hours emergency. 

What Is the Procedure for Restoring 
Files? 

Assuming your users have to go to the IT staff to get files 
restored, exactly what is the process—make a phone call? Fill 
our a form on the intranet? Send an email? What if the user 
doesn’t know the exact file name, date, or location? Is there 
a dllTerent procedure if a whole drive or user folder has to 
be restored? Spell out, in simple end-user terms, w^hat 
someone has to do to get back data that’s in the backup 
archives somewhere. And, if you have a system that lets users 
restore their own files, point them to a step-by-step guide on 
a Web page somewhere for how to do this. 

You, as an enlightened techie, will understand that it’s 
not alw'ays quick or easy to retrieve data from backups. In 
some case.s, it might require fetching an offsite data set, 
waiting until there’s a free tape drive, and laboriously 
searching through archives. But lots of people will assume 
that restoration should be immediate. Therefore, it doesn’t 
hurt to put estimated lime ranges for restoring files in your 
backup policy so that your users can set their expectations 
appropriately 

How Is Data Integrity Verified? 

You can't assume that your backups are perfectly and 
indefinitely intact, just because your backup softw^are didn’t 
report any errors. Stuff happens. Make it an explicit part of 
your backup policy to test backups on a regular basis. When 
1 .say ’’test," again, I don’t merely mean run through a 
verification procedure with ytjur backup soltware. I mean 
actually restore files. Ideally, you should at least spot-check 
a few random files on each piece of physical media once 
every month or tw'o. Less frequently, it wouldn’t hurt to 
attempt much larger restoration.s. If you catch bad media or 
unrepcjTted softw'are errors early, you 11 be able to make 
adjustments before someone aciually needs a file. 

Other Details 

Beyond the three key categories of backup procedure, 
media management, and data restoration, you may want to 
think through a few^ more miscellaneous details and include 
them in your backup policy. 

Definitions 

Because your backup policy is a document intended not 
just for computer geeks but for executives and run-of-the- 
mill employees, make sure you spell out exactly wliat 
everyrliing mean.s in nontechnical language, ft might be 
helpful to have a brief ’’definitions" section tow'ard the 
beginning where you state just what you mean by words like 
“backup," “incremental," and “restore." 
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Responsibility 

Even though you've already specified where people go 
when they need to have files restored, your policy should 
also indicate other responsible parties. Who has physical 
access to the backup media? Who knows the pass phrase for 
encrypted backups? Who makes the policy decisions? These 
might be titles or positions rather than individual names, but 
either way, make it clear. 

Maintenance 

The hardware that backs up your computers—the 
servers, tape drives, hard drives, and so on—need.s routine 
cleaning and other maintenance. Some components may 
need to be replaced or upgraded from time to time. Backup 
software will require updates. Slate in your backup policy 
who’s responsible for maintaining the sy.stem, and (at least 
in broad terms) whai .sort of maintenance schedule is 
followed. 

Private and Public Policies 

fve been advocating the creation of a backup policy 
that every single computer user in your organization will 
read. But sejme facts aren't really for public consumption— 
tilings like encryption pass phrases and the exact location of 
offsite storage. Afso, .some of the implementation details are 
too technical for the average user to be concerned with. So 
consider creating tw'o dil’ferent versions of your policy 
statement. One will be a short, snappy, one-page overview 
for the common folk, and the other will he a thorough guide 
for the technical people who will implement the system. 

Final Thoughts 

Your finished backup policy, which should be a great 
deal shorter than this article, serves two important purposes. 
First, it should guide the creation (or rehabilitation) of your 
backup system, ensuring that all the important factors are 
weighed before reaching specific hardware, software, or 
implementation decisions. And second, it tells everyone who 
uses your network exactly what to expect—from the 
technology and from you. Will their data^ and their company, 
be safe in the event of a major catastrophe or a minor user 
error? Making sure that’s true is the function of your backup 
system, and conveying a sense of confidence to your users 
is the function of your backup policy. 
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AppleScript and BBEdit 

Extend and enhance your BBEdit experience 
with AppieScript 


.. . 

by Jose R.C. Cruz 


Introduction 

The BBEdit text editor is tlie Ha^ship product of Bare Bones 
Software. It came onto the .scene in 1992 as a better alternative 
cm’r tile anemic TeachText. Now^ it's a pt>piilar editor for writing 
source ccxltv HTML and XML files, and even regular text files. Its 
feiture set includes support for more than 32K of text, regex 
search and rej^lace, syntax coloring, and tag palettes. Its Mac OS 
X version can also supports Hyth Apple^icrij^i and shell scripts. 

This anicle shows how you can use AfipleScript to enltance 
your BBEdit setup. First, it provides a ^^eek into BBEdii’s scripting 
dictionary. Next, it introduces tlie BBEdit Script menu. Then it 
shows how to attach a script to any of BBEdit's menu items, The 
article also c\)mes with exaiitples of useful scripts, 

fhe anicle assumes tliat you are lamilmr with the AppleScript 
language and tlie Script Editor. Also, its example scripts are all 
available from the MacTech site at the following URL^ 
ffp.mactech .com/ snc/moctech/volume24_2008/24.08, sif 

The BBEdit Dictionary 

The BBEdit scripting dictionai'y (Figure I ) consists of eight 
AppleScript suites. The first three suites, define the 

methods and properties that most scriptahle applications share. 
The Required suite defines thtJse that all application must have. 
The Standard suite defines those [hat are common to most 
applications. And the Miscellaneous suite defines are those that 
an application may have. 



The remaining four SLiites (colored) are unique to BBEdit. 
Each suite defines tlie methods and properties needed for a 
specific task. To use any of tht\se methods or properties, make 
sure to call liiem within a tell..*end tell bkx'k, as follows. 

tell application "'BBEdit** 

-— call tlie BBEdit methods and properties here 
end tell — applicatipn "BBEdiP 

Centering all the methods and propeiTies in detail is beyond this 
article's scope. Instead, this article will focu.s only on methods 
and properties used by its script examples. 

The BBEdit suite 

The BBEdit suite (ormige) defines the methods and 
properties common to all tasks. Some will start and control a 
specific BBEdit feature. Others will access a specific BBEdit 
object. 

For example, BBEdit 8.x displays its text files in two places: 
in a window or in a drawer (Figure 2). To access the front 

window, use tlie text window property, 
tell application "'BBEdit*’ 
get text window 1 
end tell — application "BBEdit" 

To access tlie second document in the drawer, e.g. fubar. txt, 
use the text document property. 

tell application "BBEdit" 

get text document "fubar.txt" 
end tell “ application "BBEdit 

Next, you t'an read the text data in one of two ways. To 
retrieve the entire text, use the contents property, 

tell application “BBEdit" 

gat con.teiits of text window ! 
end tell — application "BBEdit" 

To retrieve only the selected text, use the selection property, 
tell application "BBEdit" 

get selection of text window 1 as text 
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Figure 2. The BBEdit display views 


end tell —application "BBEdit" 

Notice that tlie alxjve exumple tbrces die selection property Kj 
return its results as text. Hut if you remove the as text option, 
tile properly returns iCs results as a fungc of 

You can alscj use the same two properties to replace die data. 
For example, to miMce the mtire text lo ''Lorem tpsum dolor sit 
amet”, iise the contents pixiperty as Ibllows. 

tell application "BBEdit" 

set the contents of text window 1 ^ 
to "Lorem ipsum dolor sit amet" 
end tell — application "BBEdit" 

To replace emfy the ^ielected text^ u.se the selection property as 
Ibllows. 

tell application "BBEdit" 

set the selection of text window 1 
to "Lorem ipsutn dolor sit amet" 
end tell —application "BBEdit" 

Finally, you can display other text cLita in a separate window. 
To do so, first trse the make metliod to create a new text windows 
Then display the text "Lorem ip sum dolor sit amet'' as 
follows. 

tell application "BBEdit" 
make new text window 

with properties [contents:"Eoreiti ipsum dolor sit 

amet ”\ 

end tell —application "BBEdit" 


get word B of text window 1 
end tell —application "BBEdit" 

To read the fifth word of the sixtli line on 
that same window, include a line 
property. 

tell application "BBEdit" 

get word 5 of line 6 of text window 

1 

end tell — application "BBEdif' 

To read 10 words, starting at the fifth woal, 
from the document foobar-htni use the 
word property with a thru keyword. 

tell application “BBEdit" 

get word 5 thru 15 of text document 
“foohar.htm" 

end tell —application "BBEdif 
To change tlie fifth line of the ftont text 
window' to "'Lorem ipsum dolor'i use 

the line property as follow^s. 
tell application "BBEdit" 

set line 5 of text window I to 
"Lorein, ipsum dolor" 
end tell —application "BBEdil" 

BBEdit defines words as those text 
elemenis that have only letters, numbers, or 
fxUh. !i treats spaces, punctuatioas, and 
otJier diameters as iMimiters. Qinsider Uie 
following line of sample text, 

^ 123 BBEdit ptoperty_l ??? 

BBEdit sees c:)nly fbur wc)rds in the above line^ 123, BBEdit, 
property, and 1. It sees the remaining elements as text delimiters. 

The HTML suite 

The HTMI. suite C tvd) defines the methods and properties used 
tor wel>related tasks. Some work on the liTML data displayed by 
the front text window^. Others work on daUi stored on a file. 

For example, to check tlie H'iML dati on die font w^iiidow, use 

the balance tags method, 
cell application "BBEdit" 

balance tags of text window I 
end tell —application "BBEdit" 

BBEdit returns a TRUE if tlie FffML daKi is well formed; odieiwise, 
it returns a FALSE. To check die data on tlie file f oobar.htm, use 
die check syntax ineditKl. 

set tPth to path to sires folder from user domain as string 
set tPth to tPth & “foobar.htm" 
tell application “BBEdit" 

check uyntaix of alias tPth show results true 
end tell — application "BBEdit" 

The above script aSxSumes dial die file Is in die Sites subdirectoiy of 
die home directory. Also, BBEdit displays any emirs it finds in a 
sejyarate window. 
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The Text suite 

tlie Text Suite (gtmn) defines die properties that refer to 
specific teoct elements. Use them to read c)r change parts of the text 
data, 

For example, to retrieve the diird word on the front text 
w^indow, use the word property. 

tell application "BBEdit" 


The Unix suite 

Tlie Unix suite (hitte) defines two methods for running a shell 
script from BBEdit. Make sure diat the .script starts with a valid #1 
header. Otherwise, it will either fail to mn or temiinate widi an error. 

Suppose you have die shell script foo.sh displayed on a 
BBEdit text window. To run the script, use to run unix script 
method. 
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tell application "BBEdit"' 
run un±K. script 
end tell — application "BBEdif 

To run only tlie selected portion of that script, set the selection 
only option to TRUE. 

tell application “BBEdit"* 

run Unix script selection only true 
end tell —appbcation "BBEdif 

To display the results of the script in a separate window, add an 

output to option as follow^s. 
tell application "BBEdlt" 

run Unix script output to new untitled window 
end tell — application "BBEdif 

To p:iss values to tlie script, first prepare die values as a list. Then 

pass die list to the script as follows, 
set tArg to {"foobar’', 24[ 
tell application “BBEdit** 

run Unix script output to new untitled window 
end tell —application "BBEdit" 

The script reads the above values as positional parameters. 

Now, suppose you have the script f oobar, sh stored in your 
Docum6ntS directory. To mn that script on the text in the front 

window; use die run unix filter method, 

set tPth to path to documents folder from user domain an 
string 

set tPth to tPtb & *"£ oohar. ah” 
tell application “BBEdit" 

run Unix filter alias tPth 
end tell — application "BBEdif 

In tlie alxjve example, BBEdit replaces tlie text witli tlie output of 
the script. To save die script output in a sepcimte file, sci die 
replacing selection option to FALSE. 

set tPth to path to documents folder ftotn user domain as 


string 

set tPth to tPth 6: “foobar .sh'" 
tell application “BBEdit" 

run Unix filter alias tPth replacing selection false 
end tell — application'"BBEdif 

Here, BBEdit saves the output in the file Unix Script Output. 
It also stores this file in the path --/Application 
Support/BBEdit/Unix Support/. 

Running Scripts From BBEdit 

You can run your AppleScript scripts from BBEdit's Script 
menu (Figure 3), For your scripts to appear in this menu, make 
sure to store them in the directory path -/Application 
Support/BBEdit/Scripts, 
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Figure S. The BBEdit Script menu 
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You can also remove the Script menu if you have no need 
for it. To do so, hrst choose Preferences from the BBEdit menu. 
Click on the Menus entry to display its preferences panel. Then 
click on the checkbox Scripts to dear it (Figure 4). You should 
see the Script menu disappear from the menu bar. 
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Figure 4. Disabling the Script menu 

To restore the Script menu, follow the .same steps to display 
the Menus preferences panel Tlien click on the checkbt>x 
Scripts to set the option. 

Using the menu 

The Script menu gives you easy access to wrious scripting 
resources. For example, to launch tlie Apple Script Editor, choose 
tlie menu item Open Script Editor from the menu. To view 
BBEdit's scripting diciionaiy; choose the menu item Open 
Scripting Dictionary, lb view the contents of the Scripts directory 
from the Finder, choose Open Scripts Folder. 

The Script menu also lets you record your actions without 
leaving BBEdit. To begin tlie process, choose tlie menu item 
Start Recording. BBEdit will record your actions within and 
perhaps witltout. 

To end tlie process, choasc the menu item Stop Recording. 
BBEdit then prompts you for a filename for tlie script. Also, 
BBEdit saves tlie script in its Script directory by default. You can 
then use the Script Editor to open the script and make any 
changes you see fit. 

Currently, BBEdit d(x?s not let you to choose a different 
script editor such as Script Debugger. This limitation may change 
in future versions of BBEdit. You can also override tlie Open 
Script Editor menu item u.sing a mmtt action script 

Order of display 

The Script menu lists the contents of its directory in 
alphanumeric order. If its directory has other subdirectories, the 
menu lists them in the same order as w^elJ, 

You can, however, change the order in which each script or 
directory appears on the menu. All you liave to do is to add a 
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numeric prefix to their names. Assume, for example, you have 
the following items in Figure 5, Tlie Script menu displays these 
items as shown in Figure 6. 



Figure 5. Contents of tKe Script directory 


aardvark ► 

alsacian 

foobar 

foobie ► 


Figure 6. The Saipt menu before reordering 


Now change tlie name of script foobar to 02) foobar. 
Also, change the name of subdirectory foobie to 01) foobie. 
The Script menu will now reorder these items as shown in Figure 
7. Notice that the menu excludes the number prefix added to the 
two names. 
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Figure I The Script menu after reordering 


Example menu scripts 

The following are three examples of scripts for the BBEdit 
Script menu. They operate on any text selected on the front text 
window. For reasons of length, some examples show only the 
main parts of the script. You can always download the examples 
fom the MacTech website if you want to see die entire scripts. 
Feel free to modiiy these scripts to suit your needs. 

The script in Listing 1 is a very simple one. This script 
encodes the selected text using a ROT-13 algorithm. It then 
displays the encoded result m a .separate window It also sets the 
title of tlie output window to that of the source window plus a 
.rot 13 suffLX. 

Listing l.The menu script Encode in ROT- 
13 

on run 

local tTxtp tDoc 

tell application “BBEdit" 

— retrieve the selected text 

set tTxt to the selection of text window 1 
set tTxt to tTxt as text 

— retrieve the document title 

set tDoc to name of text window 1 
end tell —application "BBEdit” 

— validate the selection 

if (length of tTxt is 0) then 
display alert 

"Script Error" message 

"You have not selected a text to be encoded" as 
Informational 
else 

— rotate the selection 

set tTxt to rotate given target:tTxt 

— modify the file name 

set tDoc to appendRotl3 for tDoc 
tell application "BBEdit" 

— create a new text window 

make new text window 

set name of text window 1 to tEoc 

— display the rotated text 

set the text of text window 1 to tTxt 
activate 
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end tell — applicationif 
end if 
end run 

property kABC : "abcdefghijklnmopqrstuvwxyz" 
property kNOP i “nopqrstuvwxyzabcdef&Mjklm*' 

— Attach the ROT-13 suffix 

to appendRotll for aNom 
local tOld, tMod* tSuf 

— set the text item delimiters 

set tOld to text Item delimiters of AppleScript 
set text item delimiters of AppleScript to 

— dissect the filename 

aet tMod to text item 1 of aNom 
set tSuf to text item 2 of aNom 

— modify the filename 

set tMod to tMod & “-rot13.” 
set tMod to tMod h tSuf 

— restore the text item delimiters 

set text item delimiters of AppleScript to tOld 

— return the modified name 

return (tMod) 

end appetidRotll —for aNom 

— Subject the text to a ROT-13 algorithm 

to rotate given target:aTxt 
local tPos, tChr, tl+st 
local tRot 

— disassemble the target text into its characters 

set tRot to 

set tLst to characters of aTxt 

repeat with tChr In tLst 

— check against the stream of lower-case 

characters 

set tPos to offset of tChr in kABC 
if {tPos > 0) then 

set tRot to tRot £i (character tPos of kNOP) 

else 

set tRot to tRot S tChr 
end if — (lPos>0) 
end repeat —with tChr in list 

— return the rotated text 

return (tRot) 

end rotate — given tai^gehaTxt 

The script in Listing 2 is a bit more complex. First, it reads 
the selected text from ilie front lexi window. It tlien prompts 
the user for the recipient's e-mail address and for a message 
title. Next, the script asks the riser to choose which e-mail 
account to use. Then it uses Apple Mail to prepare a draft e 
mail message containing the selected text. 

Listing 2, The menu script E-Mail Selection 

on run 

local tTxt, tRcv. tSnd 

— retrieve the selected text 

tell application “BBEdit” 

aet tTxt to the selection Of text window 1 
set tTxt to tTxt as text 
end tell — application "BBEdit' 

— validate the selection 

if (length of tTxt is 0) then 


display alert 

"Script Error” message 

"You have not selected a text to be mailed” as 
Informational 
else 

— get the recipient details 

set tRcv to askForReceiverO 

— get the account details 

set tSnd to askForAccount() 

— send the selection 

if (tSnd is false) then 

— DO NOTHING HERE 

beep 

else 

sendMail for tTxt from tSnd to tRcv 
end if 
end if 
end rtin 

— Send the text 

— NOTE: 

— The foOowing script is a modified version of Apple's 
sample script 

to sendMail for aTxt from aSnd to aRcx 
local tKsg. tSub* tRcx 

— retrieve the following recipient data 

set tSub to subject of aRcx 
set tRcx to recipient of aRcx 

— activate Apple Mail 

tell application “Mail” 
activate 

— create a new outgoing message 

set tHs& to make new outgoing message 

set content of tMsg to aTxt h return 4 return 

set subject of cMsg to tSub 

set sender of tKsg to Item I of eSnd 

tall tMsg 

set visible to true 

make new to recipient at end of to recipients ^ 
with properties I address: tRcx] 

end tell - tMsg 
end tell - application ”Mail” 
end sendMail - for aTxt from aSnd to aRcx 


Tile script in Listing 3 much more interesting. First, the 
script counts the numlier of words and lines in the .selected text. 
Then it counts lire numixfr of sylliihles in each word. Next, it 
olculate.s the text's readibility index and grade using the Flesch- 
Kinaiid formula. It then dlspLiys the results in a dialog window. 

To keep things simple, this script approximates tlie syllable 
count as the mimhor of in each Lwrd, 

Listing 3- The menu script Flesch-Kincaid 
Index 

on run 

local tStat* tTxt. tWrd 

— retrieve the selected text 

tell application "BREdlt" 

set tTxt to the selection of text window 1 
set tTxt to tTxt aa text 
end tell —application "BBEdjf 







— validate the selection 

if (length of tTxt is 0) then 
display alert ^ 

"Script Error" message 

"Yon have not selected a text for analysis" as 
informational 
else 

— count the number of words in the target text 

set tStat to readabilityStata from tTxt 

— display the results 

set tTxt to ‘'Ease Index ^ " 

set tTxt to tTxt b. (index of tStat as string) 

set tTxt to tTxt £r [ASCII character (13)) 

set tTxt to tTxt & "Grade Level: * 

set tTxt to tTxt Si [grade of tStat as string) 

display dialog tTxt buttons ["OK"] -« 
with title "I 

"Flesch-Kincaid Readability" default button 1 ^ 
giving up after 10 

end if 
end run 

— Determine the readability statistics of the target text 

on readabilityStats from aTxt 

local tStat, tWrds. tFKI, tFKG 
local tAWL, tASW 

— initialize the statistics results 

set tStat to {3eiitEnceE:0, wordCount'O, ayllables:0, 
index:0. gradeiO] 

—^calculate the following 

—- readabiIity:count:sentences 

set sentences of tStat to numberOfLines from aTxt 


— readability;count:words 

set tWrda to numberOfWords from aTxt 

set wordCount of tStat to wordCount of tWrds 

— readability:count sylJables 

set tWrds to. wordLlst of tWrds 

set syllables of tStat to numberOfSyllables from tWrds 
try 

— calculate the following averages 

set tAWL to ([wordCount of tStat) f {sentences of 

tStat)) 

set tASW to ([syllables of tStatl / (wordCount of 

tStat)) 

— calculate the Fleisch-Kincaid ease index 

set tFKI to 206.835 - 1.015 * tAWL - 84.6 * tASW 
set index of tStat to tFKI 

— calculate the Fleisch-Kincaid grade level 

set tFKG to 0.39 * tAWL -t 11.8 * tASW - 15,53 
set grade of tStat to round (tFKG) 
on error 

set Index of tStat to 0 
set grade of tStat to 0 
end try 

— return the statistics results 

return [tStat) 

end readabilityStats —fromaTxt 
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Attaching Scripts To BBEdit 

Another way to run scripts on BBEdit is to attach them to a 
menu item. Known as nmm action scrpts, they can run l:>efore 
or after the selected menu action. They can enliance tlie original 
aaion or replace it entirely. Menu action scripts are stored in the 
following direaory. 

WLibrary/Application Snppo-rt/BBEdit/Menu Scripts* 

Also, only version 6.0, or newer, of the BBEdit application 
supports this type of scripts. 

Anatomy of the script 

Menu action scripts come in three forms. The first form 
(Figure 8) has a standard on run handler. When a user seleas 
a menu item, the script runs the handler right ajier the selecikm. 
Jt then presents the original menu action from running. 
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Figure 8. Overriding a menu item action 


The second form (Figure 9) has an on memiselect 
handler. When a user selects a menu item, the script ains the 
handler before the original action, Tlie liandler then returns a 
Bcxilean value, which tells die script what to do next. If the 
handler reUims a FALSE, the script allows die original menu 
action to nm. If it returns a TRUE, the script comes to an end, 





Us«r 





Figure 9. Preceding a menu item action 


The third form (Figure 10) has two handlers: an on 
menuselect and an on postmenus elect. When a user 


selects a menu item, the script first runs the on menuselect 
handler. If this handler returns a TRUE, the script stops, 
preventing die original menu action to run. But if the handler 
returns a FALSE, die script lets die original action to run. Then it 
runs the on postmenu select handler. 
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Figure 19, Enclosing a menu item action 


To attach a menu action script to a menu item, you need to 
name the script in a certain way The following is the syntax you 
should use lor die script’.s name. 
menu •menttjiem 

The menu string is the name of the menu on the menubar. It can 
also be die name of the hierarchical menu as well The 
metmjient string is the name of menu item itself For example, 
to attach a script to die menu item About BBEdit, use die 
following name for the script, 

BBEdit-About BBEdit 

To attach a script to the menu item Save As.„, use the following 
name. 

File-Save As.*, 

Make sure to separate the tw{) strings widi a character. If the 
menu item contains an L4iipsis, make sure to include that a.s well. 
Otherwise, BBEdit will not recognize die script. 

Example menu action scripts 

llie following are three examples of menu action scripts for 
BBEdit. These examples require version 8.x or newer of BBEdit. 
Feel free to modify these scripts to suit your needs. 

Again, for reasons of length, some examples show only the 
main parts of die script. To see the .scripts in their entirety, 
download die examples from the MacTech website. 

The script in Listing 4 overrides the Make Backup Now„. 
menu item in the File menu. First, this saipt gets die file name 
and path of the displayed text document. It then prepares the 
name of the backup tarbali using the file’s name. Next, it sets the 
backup path to the directory -/Documents/Backup. Then it 
creates the lockup tarbali in diat directory. 
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Listing 4. The menu action script 
File*Make Backup Now... 

on menuselect(aMenu, anItem) 
local tlioc< tBck 

— retrieve the document information 

set tJ3oc to pathOfDocument 0 

set tBck to backupName for (dnoni of tDoc) 

set tDoc to (dpth of tDoc) 

— backup the document 

tall tne to storeBackup for tDoc at tBck 
end mentiselect 

— Create the tarball backup 

on storeBackup foE aDoc at aTar 
local tNew. tCmd, tBck 

— prepare the tarball backup 

set tBck to pathToBackupO 
set tBck to tBck & aTar 

— does the tarball already exists? 

set tNew to pathExlsts for tBck 

“ prepare the tar command 

set tCmd to -file=^ & (POSIX path of tBck) 

set tCmd to tCmd & -label=bbedit_bsckup'* 

If CtMew) then 

“ backup:file:create 

set tCrad to tCmd i create " 

else 

— backup:file:update 

set tCnid to tCmd & -update " 
end if — (tNew) 


set tCmd to tCmd & {POSIX path of aDoc] 
try 

— execute the backup command 
do shell script tCtnd 

— inform the user 

if (tNew) then 

set tBck to ■‘Created the tarball backup at:" & 

return 

& return & tBck 

else 

set tBck to ^’Updated the tarball backup at:" t 

return ^ 

& return & tBck 
end If — (tNew) 

display dialog tBck with title 

"Successful Backup" giving up after 5 
buttons {‘‘OK”) default button 1 
on error tErr 

display alert “> 

“Backup Error” message 
(tErr as string) as critical 

end try 

end storeBackup —for aDoc at aTar 


The script in Listing 5 overrides tlie Find Differences.,, 
menu item, wMch is under the Search menu. This script first gets 
the file patli to the displayed text document. It then asks the user 
to choose a second file to compare againsL Next, the script 
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compares the two files using the command-line tool diff . Then 
it displays the results on a separate text window. 

Listing 5> The menu action script 
Search* Find Differences... 

on run 

local tDoc, tHef, tDiff 

— get the frontmost document 

set tDoc to frontDociiment () 

— get the document directory 

Bet tDoc to doclnfo for tDoc 
if (tDoc is not false) then 

set tRef to selectTarget for tDoc 

set tDiff to getDifferences for tRef against (dpth of 

tDoc) 

'— display the differences 

tell application '"BBEdit" 

— create a new text window 

mke new text window 

set name of text window 1 to "Diff results" 

— display the results 

set the text of text window 1 to tDiff 
activate 

end tell — application "BBMt" 
end if — (tDoc is not false) 
end rim 

— Get the frontmost document 
on frontDocuinent 0 
local tDoc. tPth 


tell application "BEEdit" 

set tDoc to text window 1 
set tPth to the file of tDoc 
end tell — application "BBEdit" 

— return the retrieval results 
return £tPth) 

end frontDocument 

— Display the differences between the two files 

on getDlfferences for aDoc against aRef 
local tCmd, tDiff 

— prepare the diff command 

set tCmd to "diff -ignore-all-space"' 

set tCmd to tCmd & " -text" 

set tCmd to tCmrf ^ " -suppress coimiion-lines" 

set tCmd to tCmd i “ ^ & (POSIK path of aRef) 

set tCmd to tCmd & " " & (POSIX path of aDoc) 

— execute the command 
try 

do shell script tCmd 
set tDiff to result 
on error tErr 

set tDiff to tErr as string 
end try 

— return the comparison results 
retTirn (tDiff) 

end getDifferences — for aDoc against aRef 
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The scrip! in Listing 6 overrides the Folder Listing... 
menu item. This menu item is in the hierarchical menu Insert, 
which is under the Edit menu. First, die script asks the user to 
choose a directory. It lists the contents of that directory using 
die Is command-line tool. Then it displays the results on die 
front text window. 

listing 6. The menu action script 
Insert*Folder Listing... 

on tun 

local tDir. tLst 

— ask for the target directory 

set tDir to askForTargetC) 

— get a list of contents from that directory 

set tLst to iistContents from tDir 

— display the results 

S 0 t tDir to “Contents of the directory:” ^ return ^ tab 
& (POSIX path of tDir) 
aet that to tDir S return S tLst 
tell application 

set selection of text window 1 to tLst 
end tell — application''BBEdit" 
end run 

— Display the contents of the target directory 

on IistContents from aTgt 
local tLst, tCmd 

— set the shell command 

set tCrad to “Is -ASl ** fit (POSIX path of aTgt) 
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— execute the command 
try 

do shell script tCmd 
set tLst to result 
on error 

set tLst to “Unable to list the contents of the 
target& return 

set tLst to tLst & (aTgt as string) 
end try 

— return the retrieval results 
return (tLst) 

end IistContents —from aTgt 

— Ask the user for a target directory 
on askForTarget0 
local tPth 

— set the default directory 

aet tPth to path to dormnents folder from user domain 

— prompt the user for a target directory 

choose folder ”* 

“Select which directory to peruse" default location 

tPth 

set tPth to result 

— return the selection 
return (tPth) 

end askForTarget 
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SmartBackup 
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Final Remarks 

BBEdit has a strong and impressive support for 
AppleScript. It gives you a scripting dictionary with an 
extensive set of properties and methods. It allow^s you easy 
access to various scripts and script resources. It lets you 
record your actions on demand and save the results to a file. 
It even lets you attach scripts to specific menu events. 

Because of Us level of support, BBEdit continues to 
stand out against other text editors. It is also a prime 
example of what a scriptable application should be. 
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SNMP Primer for OSX Leopard 

An article on “Understanding, Configuring, and Custonnizing SNMP 
on OS X Leopard" that might change the way you think about your Mac. 


by Noah Gift 


Introduction 

If you haven’t done any work with SNMP before, you might 
be tliinking, ''who cares?" SNMP has gotten the somew^iat 
deseived reputation as being complex to administer and 
understand. As a result, many people don't care, and there are 
not that many articles that talk alxjLEt it. 

This article will attempt to present die information in a 
gentle enough manner that no experience wiUi SNMP wall lie 
required. At the same time, we will dive into a Few' obscure, but 
absolutely fascinating things that be done witli SNMP that few- 
delve into. It is quite fun to let a cat out of die bag, so let's dive 
into SNMP and see how it might just change the way you think 
about your Mac. 

Backwards First 

Because SNMP can be incredibly boring to talk about, let's 
save the obligatory overview^ of what SNMP is, the liistory of 
SNMP, configuring SNMP etc. Instead we are going to 
immediately do something useful. Just follow these steps on a 
OS X leopard machine that is not a production server. 

Step 1: cp /etc/flnmp/flnmpd.conf 
/etc/ snmp/ stimpd.conf.tiak. 052106 

Step 2: echo "cocoinniunity public” > /etc/.gnuip/snmpd.conf 
Step 3; Restart the SDtnpd daetnon by sitnply typing the 
estecutable: 
mini// Esnmpd 

Step 4: Query the disk usage of your jnachine via snmp: 


mini// snmpdf -v 
Description 

2c -c public 
slse (kB) 

localhost 

Used 

Available 

Usedy. 

Physical memory 

1310720 

321440 

489280 

62% 

Swap space 

65532 

0 

65532 

0% 

y 

77314832 

51153396 

26661436 

65% 

/dev 

1 

1 

0 

100% 

/dev 

1 

1 

0 

100% 

/net 

0 

0 

0 

0% 

/bonie 

0 

0 

0 

0% 


Hopefully these simple four steps did the equivalent of 
dropping a suitcase nuke on your preconceptions about SNMP. 
Let's now go over what we did in detail now. In the first step 
we simply made a backup of the snmp configuration file, and 
added a date stamp on it. 


In the second step we overwrote the whole snmpd.conf 
file by simply echoing out one line of configuration syntax; this 
effectively erases pages upon pages of almost completely 
useless configuration data you wall never use. This in fact is one 
of the iiiggest stumbling blocks to understanding new 
technology, too much information. 

In the tliird step we told snnipd to start the daemon so we 
can c^uery it. (We will gel into la undid configurations later). 
Finally in the fourth step, we ran a specialized snmp tool that 
i.s effeciively tile same as running df -k on a local machine. 

Backwards First Explained 

Now' that we have removed some of the magic liehind 
SNMP, and brought it down to the level of complexity of ssh or 
tar let’s fill in a few" of the details. The very first detail to 
understand is the cryptic syntax for the snmpdf command. If we 
look at the command again, we can liieak it dowm into the 
follow ing sections: 

snmpdf -V [SNMP Version] -c [Name of community string] IP 
Address or hostname 

Fortunately, all of the Net-SNMP command line tools 
follow this same syntax, so you will only need to understand 
one tool to understand the rest. I’he -v option refers to which 
version of SNMP you wish to use. The available options are 1, 
2c, and 3^ Versions 1 and 2c are not encrypted so they are only 
safe to use in a secure firewallecl environment, and version 3 
requires more explanation and setup. If you just want to setup 
.snmp at home behind a hrewall, then 2c is the version you will 
most likely w"ani to use. 

Tlie next Bag -c refers to the community string. With SNMP 
versions 1 and 2c, the auihentication system revolves around 
setting community strings to grant access to the snmp daemon. 
There are w^ays to set community strings to allow read access, 
which is what we did in the section above, and also to allow' 
read/wTite access. In this case, we went w ith a convention and 
used public as the ro, or read only community string. 
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Finally, we just typed in the name of the local machine. We 
could have typed in the name of any machine on the internet 
though, if they had snmp running and had the configuration we 
setup. This is really almost 80% of what someone needs to 
know about SNMP, we wQl cover a tew of other things later. 
Given that we are now SNMP experts, let’s write some code to 
monitor a home network for disk usage problems. 

Writing a Disk Space Monitoring System 
in Python 

Since we are now SNMP experts, and have bragged to all 
of Dur friends how we can monitor the disk usage of our 
machines remotely, we got thrown into a consulting gig ‘^by 
accident s'* Our task is to write a simple nightly monitoring script 
that checks all of the machines on a IcK'al network to make sure 
they do not have critical disk space issues. This client has 
several Final Cut Pro Suites where the editors constantly overfill 
their RAID volumes, and it is our job to write code that will 
prevent it before it happens and send the company tjwner an 
email when disk space on any volume exceeds HTO. 

With Python and SNMP this is actually a trivial, yet very 
useful, problem to solve. The first step is to write some code 
that fiags disk usage that exceeds 80%. 

listing 1; snmpdf^aiert.py 

#!/usr/bln/env python 

Parses the output of snmpdf and performs a regular 
expression match thaL searches for &0-99% disk usage 
pattern. If a match is found it prints out the volume that 
exceeds our “quota".'""' 

from subprocess import FIPE 4 Popen 
import re 

def snmpdf(machine); 

""“Returns snmpdf output as file object"”" 

p - Popen(“snmpdf -v 2 g -c public 7sS" % machine, 
shell“True, 
stdout=PlPE, 
stderr=PIPE) 
return p.stdout 

def parse(file): 

“''"Parses file object and determines if critical match 
between 80-99% disk usage is met. 

Returns collected results with new stamp line,"'"' 

collection ^ [] 
pattern = "18-9][0-9)%" 
outline = (line.split{) for ]lne in file) 
flag = (" “.join(row) for row in outline \ 
if re.search[pattern. row['l])) 
for line in flag: 

newline = DISK USAGE CRITICAL" % line 
collection.append(newline) 
if len(collection) > 0: 
return collection 


if _name_ = "_main_": 

^^prints results 

out = snmpdf ("localhost'") 

result =" parse (out) 


if result: 

for line in result: 
print line 

All this script does is to take the results from the snmpdf 
command and look tor volumes that have betw^een 80-99 % 
utilisation. If you are dealing witli editing on a local RAID 
volume, often exceeding 80% capacity will cause performance 
problems. If we run this .script on a macliine witli utilization 
problems, we get something that looks like this: 

minl^f python2.5 snmpdf_alert,py 

/ 97349872 8367S460 8671412 91% DISK USAGE CRITICAL 

We can ,see that this machine’s root volume or V, 91% 
capacity. This is obviously a big problem that we need to 
address very soon. 

In order to turn this into something that manages a 
network and emails a warning, it would be fairly easy to just 
run this in a cron job or via launchd, and mail an alert message 
if the output of the script was not None, which is what happens 
wlien there is no match for our regular expression. 

I1‘ you are new to Python some of the code may look a little 
weird, so Iktc are a few tilings to remember. First, whitespace 
is significant, st> indentations are iliere to control the flow' of the 
program. Second, if you are coming from anotlier language, 
Python is fairly easy to pick up. If you would like a reasonable 
introduction to the language please refer to tutorial listed in 
references. 

Getting Closer to 80% Knowledge 
of SNMP 

'Fhere are few things w^e glossed over in the first parts of 
the article because they were boring, but let’s get them out of 
the way 'Fliis should bring yon a bit closer, if not all the way, 
to knowing SNMR 

First, in order to get the SNMP daemon to am upon startup 
you will need to modify the plist for: 

/System/Libcary/LaunchDaemons/org.net- aninp. snapd. pliat 

And make it look as follows: 

Listing 2: /System/Lihrafy/LaunchDaemons/org.mt- 
snmp.snmpa.plm 

<'f'K]iil version="l .0" encoding="UTF-8''7> 

<!D0CTYPE pli,st PUBLIC /Apple//DTD PLIST 1.0//Et3” 

"http: //wvw. apple. coDi/DTDB/PrDpertyLiat -1,0. dtd"> 

(plist version^”1.0") 

<dict> 

<key>Disabled</key> 

(false/) 

<key)ReepAlive(/key) 

(true/) 

(key)Label(/key) 

(string)or g, net - snmp. snnipdk / string) 

(key)0 nD ema nd </key) 

(false/) 

(key)Prograiii(/key) 

<string)/usr/shin/snmpd</string) 
(key>PrograffiArgiaiDents(/key) 
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<ari:ay> 

<stri[ig>snnipd</string) 

<strlag>-f</string> 

</array> 

<key>RunAtLoad </key> 

<true/> 

<key>ServicerPG<7key> 

<false/> 

</dlct> 

</plist> 

What this does is to tell the snmpd daemon to start up 
upon reboot and then stay alive. Arguably, this eould be set 
to OnDemand instead, but this is one of the newer features 
of launchd and it hasn't been fully tested with snmp much. 

Next, we need to talk a little bit about the snmpwalk 
command, OlDs, and MIBs. The very .short explanation of an 
OID is that it is a string of numbers, with a human readable 
name, that lives inside of a MIB file. This whole system is a 
hierarchically-assigned namespace for the SNMP protocol to 
keep track of what an agent can provide when you query it. 
Let's take a look at how the snmpwalk command is used 
to shed some light on this. Here is a basic snmp query of 
our local machine again using the OID sysdescn 

mini# snmpwalk -v 2c -c public localhost sysdescr 

SNMPv2-MIBr:sysDescr.O = STRING: Darwin mlnl^local 9.2*2 
Darwin Kernel Version 9*2.2: Tue Mar 4 21:17:34 FST 
2008: root:xnu-122a*4*31-'l/RELEASE_I3B6 1386 


By examining the command we ran you may notice the 
syntax is identical to the *syntax of the snmpdf command, 
with the exception of the word sysdescr* This w^ord is an 
OID, and it lives in the MIB-2 file. You can refer to the 
references for an actual breakdown of this OID and where 
it lives in the larger MIB structure if you are curious, but if 
just want to use SNMP you only need to know important 
OID’s to query. 

As our last mention of this topic, it is important to know 
that die snmpwalk command retrieves all of the OlDs that 
are listed below' it In the hierarchical structure. To get the 
superset of the OID that holds sysdescr, we could type in 
this: 

snmpwalk -v 2c -c public localhost system 
SNMPv2-MIB: : EysDesci:*0 ^ STRING: Darwin mini . local 9.2*2 
Darwin Kernel Version 9.2*2: Tue Har 4 21:17:34 PST 
2008: root:xnu-l22&.4.31«l/RELEASE_I386 1386 
SNMPV2-MIB::sysObjectID.O = OID: NET-SNMP- 
MIB::netSmnpAgentOIDs.25 5 

DISMAN-EVENT-MIB::sysUpTlmeInstance “ Tlmetlcks: (IS92500) 
5:15:25*00 

[OUTPUT SHORTENED FOR SPACE] 

This gives us not only the .sysdescr OID, but many 
others as well. For writing a monitoring .system you almost 
never query something in this manner though, you typically 
ju.st find out the important lower level OIDs, and then write 
some scripts using them. 
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This is all we are going lo cover about the very nitty 
gritty details about how SNMP is implemented. If you are 
curious, you do a Google search for these terms and you 
should gel all of the reference material you need. 


A Final Trick: 

Extending the Net-SNMP Agent 
with Python and OSAScript 

At this point we have the basics covered for 
configuring, configuring, scripting, and querying SNMP on 
the Mac. As a final trick, we are going to extend the Net- 
SNMP agent on our Mac and do somediing fun. 

We are going to write a script that tells iTunes to start 
up and play something on “Party Shuffle*’ if we query a 
specific DID. In order to do that we need double our 
already massive configuration file, or add one more line. 
Let’s make our /etc/snmp/snnipd.conf look like this: 

ro^ioiaiiunity public 

exec Playltunes /visr/bin/python / tmp/playltunes .py 

Next, we need to WTite that script so that it executes 
wlien we run. Here is what that script looks like: 

Listing 3* piayitunes.py 

#I/asr/bin/env python 

from subprocess ijnport Popen. PIPE 

cmd = “”‘'ossscript<<EHD 
tell application “iTunes*' 
play playlist “Party Shuffle” 
end tell 


def play_iTunes(}: 

PopentcDid, shGll“Ttue* etdout“PIPE, stderr=PIPE) 
print “Started ITunes Party Shuffle” 

pIay_iTunes E) 


Next w^e need to send the snmpd daemon a HUP lo tell 
it to reread it’s configuration file. Do a ps -ef | grep snmpd 
and then give the PID a kill -1. This is what it looks like 
when I do it: 

siini# ps -ef j grep snmpd 

0 26 10 0:01.S2 77 

smnpd -f 

0 515 355 0 0:00.00 ttysOOO 

sntnpd 

mini# kill -1 26 

Finally, we are ready to “query” our machine and make 
it trigger our custom script. There is a standard OID that 
responds to custom scripts and it is used in die snmpwSk 
call below; 

mini# snaipwalk -v 2c -c public localhost 

.1.3.6.1.4.1.2021-B 

UCD-SNMP-HIE::extIndex.! = INTEGER: 1 


0:02,26 
0:00.00 grep 
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UCD SHMP-HIB::e^tNaines.l = STRING: Playltunes 
tJCD‘SHMP-MIB::extCoiiiiDand.l = STRING: /usr/biny python 
UCD-SNMP -MIfl::extResult.1 = INTEGER: 0 

UCD-SNMP-MIBi:extOutput.l - STRING: Started ITunes Party 
Shuffle 

UCD-SNHP-HIB:;extErrFtx.l = INTEGER: noError(O) 
UCD-SNMP-MIB::extBrr¥ixCmd.I = STRING: 


Guido van Rossum. Python Tutorial: 
h ftp; / / docs, python. o rg /tut. 

OID Vaiue/Description of sysdescr: 

http: //www.a Ivestrand. no/objectid/ L3.6.1.2, U . 1.html 


When we run the command, and see the output, we can 
see the print statement that we included with our script, If 
we actually take a look at our machine, we will notice that 
ITunes indeed pops up, and starts (3n Party Shuffle. 

This is a slightly silly example for extending a Net- 
SNMP agent, hut if you are a home power user, maybe it 
isn’t. Who doesn’t want to brag and tell your spouse, you 
turned on iTunes via SNMP to the dc^wnstairs computer? 


Conclusion 

We covered a lot of ground in thi.s article, and hopefully 
got you to understand how SNMP might be useful in your 
computing ecosystem. There were quite a few things we 
glossed over, mostly the boring stuff, but they aren't entirely 
necessary for you to start hacking around with SNMR 

We covered about 80% of the most important material, 
and T will leave the remaining 20% for you to pick up on 
your own. If you do plan on learning more about SNMP 
theory it would make sense to read a book or two on the 
subject or read a few articles on Wikipedia on SNMR For 
casual use of SNMP though, you have more than your fair 
share to explore with the ideas from this article. 

One final word of caution though is to make sure that 
you only use SNMP version 1, and 2 if you are 
communicating on a secure LAN behind a firewall. There 
have been some high profile break-ins of machines that 
have occurred by using insecure versions of SNMP over the 
internet. If you do need to remotely query or a control a 
machine across a the internet you must use SNMP v3 to be 
secure. 
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The Road to Code 


by Dave Dribin 


Patterns in 
the Sky 

The Model-View-Controller 
.Design Pattern 

Welcome Back 

WeVe ccime a lon^ way since the first Road to Code. 
WeVe covered Foundation and AppKit, the l:jasic frameworks 
of Mac OS X, and we can write GUI applications. While 
we’ve covered the Objective-C language and classes that 
make up an application, we’ve glossed over a bit of history. 
How did Mac OS X applications evolve the way they have^ 
Why did Apple's (and NeXT’s) engineers create classes like 
NSApplication, NSView, and WSControl? The search 
for these answers takes us down a path the computing 
history. 

Design Patterns 

Ever since the dawn of computing, programmers have 
been trying to make their lives easier and more productive. 
Today we take high-level languages like Objective-C, C++, 
Java, Ruby, and Python for granted. Back in the day, 
programmers had to code in assembly language directly. 
Grace Hopper wrote the very first compiler in the 1950s to 
alleviate the pain of writing as.sembly language. In the 1970s, 
when the Unix operating system was originally being 
developed, the designers created their own language, called 
C, to help make Unix easier to port to new computer systems, 
C was one of the first and, in retro.spect, is arguably the most 
successful high-level language. The benefit of C over 
assembly language was two-fold. First, the programmer 
could write code once that would nin on multiple computer 
systems. All she had to do was recompile the C code for the 
target system and it would, if written properly, run without 
modifications. The other benefit of C code is that it w^as a lot 
more readable and understandable to the programmer Both 
of these benefits greatly simplified the programmer's job. 


C is still in active use today, either directly or in one of 
its derivatives forms, .such as C++ and Objective-C. C also 
brought with it the ability to put commonly used code into 
libraries. Code - such as displaying text to the user and 
receiving input to the user and manipulating strings - can be 
re-used by many programmers and applications. The benefit 
is that each developer can spend their time writing their own 
application instead of having to re-invent the wheel, so to 
speak. Reusing code through libraries is also a big boon for 
the programmer. 

But as grjod as reusing code through libraries is, it does 
have limitations. Sometimes, different applications perform 
many common tasks that may not be codified into libraries. 
Or sometimes these common tasks transcend the particular 
language you are using and apply to, say, any object-oriented 
programming languages. These higher-level reusable tasks 
are called desigfi patterns. Design patterns are not unique to 
software development. The term ''pattern” as a reusable idea 
originated from an architect named Christopher Alexander. 

Softw^are design has some similarities to traditional 
architecture and engineering, and design patterns are one of 
these similarities. The term design pattern in \he software 
industry was popularized by the seminal book Design 
Patterns: Elements of Reusable Object-Oriented Software. The 
book was written in 1995 by four authors: Erich Gamma, 
Richard Helm, Ralph Johnson, and John Vlissides - now 
infamously known as the '‘Gang of Four”. The Gang of Four 
(GoF) patterns book cataloged and described many design 
patterns that the authors used, or had observed in object- 
oriented applications. While the examples are in C++, the 
patterns themselves are still relevant to this day. In fact, there 
are now many hooks covering design patterns in specific 
languages, but the concepts are generally the same. 

Aside from providing solutions to common software 
de.sign problems, the benefit of using patterns is to create a 
common language and vocabulary that all programmers can 
use to help describe these problems. By providing a 
common vocabulary, anyone familiar with it will understand 
when someone says, for example, “tliis object implements tlie 
Adapter pattern to interface with the legacy database” or “ycm 
should use the Factory pattern to ensure future flexibility." 
The GoF book describes tlie Adapter pattern and Factory 
pattern in detail. 

Obviously design patterns are a large topic and not 
something that I could do justice to in a single magazine 
article. I highly recommend you pickup (or borrow) a copy 
of the GoF book and read it. Even though it may be a little 
dated and does not apply directly to Objective-C, it will 
provide you with knowledge that will benefit you for years 
to come. 
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The Model-View-Controller 
Design Pattern 

One coiTinidn design pattern For developing GUI 
applications called the model-view-controlkrpaltern or AfVC 
pattern for short. The MVC pattern, while not described 
directly in the GoF book, is an old pattern with roots in 
Smalltalk from the early 19B0s. k has proven such a 
successful pattern that it is prominent not only in modem 
Mac OS X applications in Cocoa, hut also in Ruby on Rails 
web applicadons, and now^ in native iPhone applications, as 
just a few examples. 

The MVC pattern breaks objects in an application into 
three roles: model objects, view objects, and controller 
objects. Objects in each role serve a particular function, and 
a single object should not perform multiple roles. The idea 
is to reduce dependencies, or coupling, betw'een the 
components of an application. This loose coupling promotes 
reusability of each of the individual components, 

Apple chose the MVC pattern as the basis for all Cocoa 
applications based on the success of the MVC pattern in 
Smalltalk and lessons learned in classic Mac OS, Apple used 
this experience to make programming for Mac OS X as easy 
as possible. They created the classes in AppKit and 
Foundation ba.sed on this collective experience, and these 
classes are now available for your use. 

The Model 

Model classes and objects are the core of your 
application. Think of tliem as your application, without a user 
interface. If, for example, you were developing an address 
hook application, you would probably have objects to 
represent each contact, as well as objects to represent groups 
of conutets. Often, model objects are saved to disk and 
loaded in future invocations. Again, for an address book 
application, you would want to store all the contacts and 
groups on disk somewhere, so they could be loaded when 
your application next runs. 

Ideally, model classes are completely independent of the 
user interface. This allows these classes to be reused in other 
applications and with other user interfaces. For example, you 
could use the same classes in a GUI, command line, and 
iPhone application. Or, you may be writing automated unit 
tests to ensure that the model objects work as desired. The 
reason these objects can be used in so many different 
situations is because they have no ties to the user interface. 
In technical terms, the model objects are not coupled to the 
user interface. 

In our previous applications, the Rectangle class 
would be considered a model object. In fact, we have already 
reused this class in multiple applications. We started out 
using it in a command line application, and then used the 
exact same class when we started WTiting GUI applications. 


The View 

View objects and classes are at the other end of the 
spectrum. Tliey represent the user interface and display 
information to the user. However, they are not responsible 
for staring the data they display. For GUI applications, weVe 
already seen a number of view classe.s. For example, 
NSButton, KSTextField, and NSWindow are view classes. 
The MSApplication class is also considered part of the 
view as it represents the hub of a GUI application. Again, the 
main purpose of making generic view classe.s is to make them 
reusable in many applications. You could say that much of 
the AppKit framework is comprised of view classes, and the 
fact that AppKit provides so many pre-made view classes is 
one reason why it is easy to develop GUI applications for Mac 
OS X. 

By designing AppKit using the MVC pattern, Mac OS X 
applications get to stand on the shoulders of giants. As 
programmers, we get to build on Apple's wealth of 
experience creating and designing GUI applications. 

The Controller 

Controller objects sit between the model and view 
classes and shuffles data back and forth. The GoF book 
describes a Mediator pattern where an object works like a 
real-world mediator communicating between two separate 
parties. The controller objects often follow this Mediator 
pattern. 

One of the controller’s responsibilities is to keep the 
model and view in sync. Figure 1 shows how the models, 
views, and controllers interact with each other. You can see 
the user interaction from the view goe.s through the 
controller. This user interaction is often in the form of targets 
and actions, For example, when a user clicks a button, the 
action method is on a controller class. The controller class Is 
responsible for taking data out of the view and updating the 
model class. Conversely, if the model object changes without 
user interaction, it notifies the controller. It then updates the 
view accordingly. The controllers also generally act as the 
delegate and data source for views. 



Figure 1: Model-View-Controller interaction 
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Hello World as MVC 

Let's look at some of our programs through the MVC 
prism* The GUI from our original HelloWorld rectangle 
application is shown in Figure 2. The user interface is made 
up of standard Cocoa controls: a window, some text fields, 
and a button. These are all considered part of the view. 


#4 0 0 Window ^ 

Rectangle Width: 

1.5 

Rectangle Height: 

10 

Rectangle Area. 

SO 

Rectangle Perimeter; 

30 


Calculate ^ 


Figure 2: Rectangle application window 


The rest of the application, was implemented in two 
classes: HelloWorldController and Rectangle. As I 
mentioned above, the Rectangle class is considered a 
model class. The name 1 chose for 

HelloWorldController may not have made sense back 
then, as we didn’t know about MVC, but it should be clear 
now. Since it performs the role of a controller class, I named 
it accordingly. Let’s take a quick look at the interface for 
HeLloWorldControiler in Listing 1. 

Listing 1: HelloWorldControllenh 

^import Cocoa/Cocoa.h> 

@clafiS Rectan&le: 

©interface HelloWorldController : NSObject 
[ 

iBOutlet NSTextField * _wldthField: 

IBOytlet f^STextField * _he±ghtField; 

IBOutlet NSTextField * _areaLabel; 

IBOutlet NSTextField * _periiiilterLabel: 

Reetangle * _rectangle; 

I 

- CiBAction) calculate: (id) sender: 

©end 

This controller class has outlets to the text field, a 
calculate: action, and a _rectangle instance variable* 
Outlets and actions are generally how controllers and views 
are hooked up. Actions are used by views to notify the 
controller of a user's action. The controller uses oudets to get 
current values from die view and update the view to new 
vales of the model. 


When the button is clicked and the action method is 
performed, the controller updates the rectangle instance 
vaiiabie from the width and height text fields, and finally it 
update,s the area and perimeter text Fields: 

- {void} updateAreaAndPerimEter 

f 

LareaLabel setFloatValue: ^rectangle.area]: 
LperliiiterLabel setFloatValue: _rectangle*perimeter] : 

I 

- tlBActioD} calculate: (id) sender 
E 

_rectaTiglG . vidth = [_widthPield floatValue] : 

^rectangle.heigbt = LbelghtField floatValueJ: 

[self updateAreaAndPerimeter]: 

1 

You can see even in this simple example how the model 
view controller works. Data Hows from the view to the 
model and vice versa tlirough the controller. The controller 
receives a user action and updates both the model and the 
view to keep them in sync. 

Model-View-Controller in Cocoa 

You are highly encouraged to follow die MVC design 
pattern when writing your own applications. If you do, you 
will find that the Cocoa environment will help you get your 
job dcme faster. Apart from providing a rich set of view 
classes, there are some other benefits to following MVC. 
Some of the more advanced Cocoa technologies rely on MVC: 
Document Architecture - Document-based applications 
follow the MVC pattern with your KS Document subclass 
playirtg a controller role. When we changed our single 
window application to a document'based application that 
could save and open rectangle documents, we modified the 
Rectangle to implement the NSCoding protocol. By 
giving the Rectangle class the ability to convert itself to 
and from a sequence of bytes, it stays consistent with the role 
of a model class. However, it was the controller class that 
interacted with the view to perfonn die actual saving and 
loading to and from a file. 

Cocoa Bindings - Bindings is a technique that allows you to 
remove a lot of repetitive code from of your controller 
classes. This is an advanced technique that in turn relies on 
key value coding (KVC) and key value observing CKVO). We 
will cover these topics in due time. 

Core Data - Core Data allows you to easily create complex 
model objects and save diem to disk. This allows you to 
remove a lot of repetitive code from your model classes. 
Again, we will cover Core Data in a future article. 

Conclusion 

The Model-View-Controller design pattern was identified 
as a way to de.sign GUI applications that promotes loose 
coupling and reusability of its components, Apple chose die 
MVC pattern as the foundation for AppKit based on its 
previous success in Smalltalk, Because of this, you should 
design your Mac OS X applications with the MVC pattern in 
mind. It ensures your code is as reusable as possible, which 
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is always a good thing, as you never know when you may 
need to use your model classes in another application. You 
will be glad you fallowed the MVC pattern when you do. As 
we will see in upcoming articles, Cocoa also rewards those 
following the MVC pattern. 
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_ Book Rsview _ 

by Edward Marczak 

Take Control of Mac OS X Backups, 

Take Control of Easy Backup In Leopard 

Two backup titles in the Take Control of series 


Introduction 

The Take Control of series of electronic bcx)ks has become 
a staple for many computer users-typically those just iieginning 
a particular topic. Two titles From Joe Kis^self ""Take Control of 
Mac X Backups'" and ‘"Take Control if Easy Backups in 
LeoJjarcT also Fall into the Ix^ginner to mid-level category. 
That's not a slight at the subject matter: joe knows his audience 
and leads them through the topics at hand skillfully. 

Take Control of Mac OS X Backups is the heftier, deeper 
work, suitable For single users with a fair amount of data to 
back up through people running a liome or snralboffice LAN 
needing to backup multiple data sources. Tal^ Control of Easy 
Backups in Leopard, as die tide implies, is aimed more at the 
home user with one or two maciiines to independently back up 
and primarily focuses on deciding if 'Fime Machine Ls die right 
tool for die iob. 

Bodi titles are released in print and as e-lxxiks, delivered 
as a PDF that you download. The e-botiks have die advantage 
of being Aide to be updated as die author updates the material. 
It also makes it easy to search and carry with you. 

Take Control of Mac OS X 
Backups 

Tile first tiook in this review is die 178 page Take Control 
of Mac OS X Backups, version 2.1 (yes, as an e-bo<ik, it gets a 
version, and youTe entitled to updates). It's the older and 
denser of the two ddes, and consists of 7 core chapters with 5 
appendices and a glossary. To quote tlie author in the early 
Readme efutpter, “I’ve written this bcxik primarily for people 
who need to back up either u single computer or a small 
network—not for .system administrators who need to back up 
dozens or hundreds of machine.s ” That said, the first core 
chapter, '"Decide on a Basic Backup Strategygives excellent 
advice to anyone getting into the details of backup. This 
chapter immediately dispels the myth that there’s any silver 
bullet for backup that takes planning and vigilance away from 
the administrator. 

The first core chapter also quickly makes the reader aware 
of the various processes-and the differences between 
them-that are referred to as “back up:'’ duplicating, archiving 
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and synchronizing. From there, readers are pul through the 
paces of identifying .special .situations: the photographer, the 
video or audio artist, etc. Each has special and different backup 
needs compared to someone that performs research and 
creates documents using a Word proc’essor. Overall, readers 
are asked lo think about their backup scenario and understand 
that it is unique. This chapter also contains .sections on backing 
up w'hile traveling and handling Windows files and partitions 
(for those of you Boot Camp users). 

The next cha[iter, "^Choose Your Hardware/ leads you 
througli deciding on which medium-or mediums-'you will use 
as your backup targets. As this version of the book was 
produced in mid-to-late 2007, 1 was surprised to see any 
mention of Iomega in the text Lit idl (do our younger readers 
even know who Iomega ist). TTie reniLiinder of the chapter is 
perfectly reasonable, helping users tlirough the myriad of 
choices in this arena. These choices include Hash drives, 
through hard drives up to remote storage options. 

Hardware is useless w itlKJUi tlie software tliat will copy the 
data to tliose targets. Tlte '^Choose Your Software” chapter is 
another 'diinking' chapter in that it really makes you think 
al'jout wTiafs important in a backup application for your 
situation. There are specific programs mentioned, but the 
empfuisis is really on features to look lor in backup software. 
The (jptions listed range from do-it-yourself UNIX command 
line options, to old-guard standards like Retrospect up to 
newTomers like Crashplan. Software choices are paired wTlh 
specific hardware options as described. 

The final chapter before die appendices helps die reader 
pul it all together Configuring parts of the OS, configuring die 
backup targets and readying rhe software. One point 1 disagree 
with in this chapter is the advice to avoid File Vault. I've 
personally been using File Vault to protect my home directory 
for a long time and have never had an issue. Not to say that 
Mr. Kisselfs note that corrupdon can rend a File Vault archive 
unusable; that is tme. More to rhe point, this is the perfect 
combination: when using File Vault, you need to have a backup 
plan! Perfect combination. Full disk encryption prtxlucts 
hadn't been announced at all at the time of veislon 2. Us 
writing, however, diere are now tliree products (one shipping 
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and two on the way) that will hilly encrypt a boot drive on an 
Intel Mac, obviating the need for File Vault altogether This will 
ultimately be the best bet, but for now, File Vault is a gcKid 
option, but one should absolutely have a backup plan when 
using it. On a high point, the chapter does talk about media 
management and restoring just as much as backing up in the 
first place. 

^Iiere's even more to the book, but I'll leave that for you 
to find. I he Ixioks is w'ell worth the $15 purchase price, and 
Joe Kissell himself tells me that he's hard at work on updates 
that include up to date status on hacking up in Leopard. 
Purchasing die e-lxiok now allows you to update to new 
versions as tlieyVe released. Also, currently, purchasing this title 
also gives you Take Control of Easy Backups in Leopard. Find 
out more at the web site for the book: 
http:/ / WWW. to kecontrol books. com / bo ckup“ mocosx. h tm I. 

Take Control of Easy Backups in 
Leopard 

Jn appropriate contrast to Take Control of Backups in OS 
X, which addresses multiple machines and small network 
backups, Take Control of Easy Backups in Leopafd is as simple 
the title would lead you to believe. This is the book you give 
to a switcher or someone entirely new to computers. It’s 
intended for a home user who deals primarily with one 
machine and wants or needs a backup in place quickly and 
easily. Its roughly 78 pages are direct and useful. Tliis review 
covers version 1.0 of die e-book title and I’m told Joe is Iiard at 
work on updates to this title, which owners will be entitled to 
dow^nload when available. 

While similar in structure to Take Control of Backups in OS 
X, all of the options presented are simplified. For example, the 
book only deals with external hard disks as targets for backups. 
No tape, no LAN-based backup, and so on. lliis is entirely 
appropriate, of course. 

Most imptjnandy, like die other tide in this group, Take 
Control of Easy Backups in Leopard makes the reader think 
about their set up. Tlie “easy” tag in the title is not a substitute 
for 'sloppy’ or 'corner-cutting.' Concepts like off-site backups 
and the importance of rotating backup media are discussed 
here, tw. 

From this point, the reader is guided through preparation 
of backup largeLs and a backup scheme. The bulk of the book 
then focuses on Time Machine as a backup program. Again, 
thi.s is completely appropriate given the audience the title is 
targeted at (“easy/ remember?). Other utilities are lightly 
touched on, folkwed by a chapter on restoring your backups 
for “When Disaster Strikes" (the title of the chapter on 
restoring). 

This book alone comes in at $10—just right for the 
audience it serves. Find out more at the page for the e-book at 
h ttp: //WWW. to kecontrol books. com/leopa rd -easy- backup, htm I. 


Conclusion 

Both titles are a good value: the information is always 
practical, and the e-books are updated as new information 
comes to light (read: as Apple fixes bugs and updates their 
software and fimctionality changes). After having read either of 
these titles, a trepidations new user will feel more comfortable, 
in control and knowledgeable. Although intended for 
beginners in the respective 'small’ categories - small business 
network or home user with a single computer - I’ve met IT staff 
in larger organizations tliat could learn a thing or two about 
backup from Take Control of Backups in OS X. Most 
importantly, diese titles make you think about backup in your 
.specific situation. Tlie Take Control web site offers sample 
chapters, so, if you're still not convinced, go download a 
sample and check it out for yourself. 
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Axiotron 

ModBook 

The ModBook is the right 
soiution... for some peop/e 

by Dennis Sellers 

If youVe been m)und the industry for a while, you 
undoubtedly have been asked about what Mac tablets are 
available. The ModBook from Axiotron 

(http://www.axiotron xom) will make those who need to 
plan and draw very, very happy. Especially those who 
diagram, or are in the graphic de.sign, visual arts, architecture 
and similar fields. The world's only Mac tablet is a mf)dified 
Apple MacBook — hence the name. In fact* when you buy 
one of the “tablet-ized” laptops it comes in the original box 
of the MacBook thaTs been modded. 

The ModBook is an US$2,290 or $2,479 slate-style 
computer. lt*.s a tablet device, bin not a touchscreen product 
( more on that in a minute). The less expensive model sports 
a 2 .IGH 2 Core Duo processor, 1GB of RAM, a CDRW/DVD- 
KOM Combo Drive and a 120GB hard drive. The higher end 
ModBook touts a 2.4GHz Core Duo processor, 2GB of RAM, 
a double-layer SuperDrive and a I 6 OGB hard drive. 
Perfonnance specs are the same as lht>se of the MacBook on 
which the ModBook is based. 


Both models retain all the ports and features of the 
Apple laptop, including the iSight webcam. However, the 
folks at Axiotron have added Wacom Pen-enabled hardware 
for pen input and have equipped the tablet computer to 
work with Apple's Inkwell, a Mac OS X 10.4 feature that 
provides system level handwriting and gesture recognition to 
several Mac applications. 

They've also added a built-in Global Positioning System 
(GPS). To many, this may seem more of a gimmick than a 
useful feature since the ModBook is very hefty for a GPS 
device, but for others, they will be glad it's there. Thankfully, 
you can turn GPS off to spare the battery. 

With ail the extra goodies, the ModBook is slightly 
deeper and heavier (T.I 6 inches and 5,5 pounds) than an 
unmodified MacBook (LOS inches, five pounds). Most of the 
extra heft is due to the dual-layer magnesium frame, triple¬ 
layer plated magnesium top .shell and ForceGlass screen 
cover These bulk up the tablet computer a bit, but it also 
makes it very rugged and dura]>le. 

If you like your current laptop, you probably won't go 
for the ModBook. As Axiotron ha.s removed the keyboard 
and mouse. Of course, you can attach such peripherals via 
the USB ports, but that defeats part of the concept of the 
ModBook. It all comes down to whether you are using the 
ModBook as a tablet computer, or because you like having 
the Wacom hardware and the MacBook so closely integrated. 

Also, if you want a tablet computer that sports a touch 
.screen a la the iPhone and latest Apple laptops, the 
ModBook is not for you. All input requires you to u.se the 
.styluses that come with the device or an onscreen keyboard 
(dubbed ‘‘QuickClicks”). Axiotron says the ModBook doesn't 
respond to hand/finger touch Tor the reason that it's made 
for artists and design professionals whose work would be 
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inhibited using a touchscreen device since their hands rest 
up on the device as they draw or design/' 

These features make the ModBook a less likely solution 
for the general end user, students and office workers 
imiess they are the type of user that diagrams or draws 
things. For a user whose primary task is entering text, 
writing, email and surfing the web, a traditional laptop is 
much easier to use with a physical keyboard. As for gamers, 
well, the ModBook is not for you. 

However, creative professionals, those that diagram, and 
users in the fields 1 mentioned in the first paragraph should 
give Axiotron's tablet Mac a look. The big draw (pun 
intencHed): with it, you can draw and write directly on the 
screen. 

The stylus and touchscreen, utilizing Wacom 
techm^logy, offer 512 levels of pressure sensitivity. On one 
hand, Wacom's Intuos tablet has 1,024 levels of sensitivity 
and cOsSts about a third of what the ModBook costs. But after 
youVe gotten used to the ModBook, there’s something that 
feels natural about drawing and writing directly on the 
screen of the device. And it works great with software such 
as Photo.shop and Corel Painter. 

The Modbook will appeal to others beyond traditional 
designers. For example, an architect could carry the tablet to 
a job site, look up plans and view them in 3H applications. 
Revision notes could be drawn on-.screen and quick pics 
taken with the iSight (though aiming tlie camera would be a 
hit tricky). 

Real estate agents and insurance adjusters could use the 
ModBook to collect signatures and look up info easily. Ditto 
health care professionals, who could use the device for 
quickly viewing a patent’s chart and making quick notes. It’s 
also great for diagramming (for example, a network 
administration drawing network diagrams), jotting down 
notes during brainstorniing sessions and helping project 
managers juggle projects. 

For wiiat it is, Modlxxjk is a great device. If you’re one 
of the previously mentioned type of potential users, the 
"world’s only Mac tablet” should be added to your arsenal 
It’s worth the money for anyone who has to constantly draw 
or (hand) write on screen. Bui for most of us the ModBook 
would simply be an expensive novelty item. 

Also note that there’s nt) Apple warranty for the 
Mod Book. You have to get it serviced (under its own one- 
year warranty) through an Axiotron authorized dealer, not in 
Apple Stores. 

YAi 
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THE MACTECH SPOTLIGHT 
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pVndy Lee 


What do you do? 

I’m a Java progranimer for Pando Networks in New York 
City. Pando is a peer-tc3-peer platform for commercial videti 
streaming. We also have a consumer app for easy file sharing. 
You might guess that I work on our Mac application, but 
actually I don’t; 1 work on back-end business logic and some 
database stuff. I do Cocoa programming in my spare time, 
often at a coffee shop or restaurant while waiting for my 
laundry. 

How long have you been doing what you do? 

I’ve been a progranimer since 1978, when my uncle got me 
my first job, as a summer hire at Exxon RM) in New Jersey, t 
was a junior in high school. 'I'hey challengei! me to find a way 
to manipulate a cursor in two dimensions on the screen of an 
Apple n. 1 managed to write a primitive diagram editor, using 
two gatne f^addles to move crosshairs. 1 wasn’t smart enough 
to invent scrolling; 1 used the keylxjard to paginate. And at the 
time 1 didn’t undetstand what a file was, so I hud no way to stive 
documents. 



As proud as 1 am, I know the app is overdue for some 
improvements. I'm working on it. 

Where cao we see a sample of your work? 

The binary and source for AppKiDo are at 
<http://Homepage, mac.com/aglee/ddwnloads/ appk(do.html>. 


What was your first computer: 

My first computer w^as a Compaq portable, back when tliey 
liad 9-inch montxdvrome screens and 5 1/4” floppies, and 
weighed thirty pounds. 1 think my flist Mac was a Mac Pius, or 
maybe one of the 512 models. My first Ccx:cja development 
machine was a NeXT cube. 

What is the advice you'd give to someone trying to get 
into this line of work today? 

Assuming you’ve already got a technical background, I’d 
say read everything you can find by Joel Spolsky. Tlien read 
everything he tells you to re;id. 

What's the coolest tech thing you^ve done using OS X? 

That would be AppKiDo. Not because there’s any rocket 
science in it. In fact, frankly, there’s some dumb stuff in there. 
One thing I’m proud tjf is that it was the first app of its kind 
that was designed to navigate the APIs conceptually — for 
example, wath a class browser, and with “quicklists” of logically 
related classes — instead of merely following the directory 
structure of the documentation. The most gratifying thing is 
when someone tells me my app helped them learn Cocoa, 
because I had beginners as well as experts squarely in mind 
w'hen I designed it. 


The next way I’m going to impact IT/OS X/the Mac 
universe is: 

First I have to add the iPlione docs to AppKiDo, There’s a 
whole new generation of beginners to help! Beyond that, my 
contributions to the Mac universe will come in the form of 
scratching my personal itches. 1 have ideas for the Mac 
equivalent of die Great American Novel, and a couple of Great 
Americ'an Short Stories. I haven’t blogged about Cocoa per se, 
but there are a couple of topics I’d like to offer my take on, like 
retain-based meniory management Lind the way it is typically 
explained. I’d like to be more helpful to the N"YC CocoaHeads 
group: I alw^ays feel personally re.sponsible w^hen It takes us 
forever to figure out wJiere we're going ftjr burgers and beer. 

rd like to thank Hoshi Takanori for writing Cocoa Browser, 
which was tremend(7usly useful to me in the etirly days, and I’d 
like to say that the Apple documentation team does a ton of 
great work that i.s often underappreciated. 

Jit I 


If you or someone you know belongs in the MarTedi SpotSghf^ kt us 
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